> ## Documentation Index
> Fetch the complete documentation index at: https://docs.csku.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kirim Catatan

> Kirim catatan internal untuk referensi percakapan. Catatan tidak terlihat oleh pelanggan.

<Callout type="info">
  Catatan bersifat internal dan tidak akan dikirim ke pengguna akhir. Catatan untuk referensi internal dan konteks.
</Callout>

## Kasus Penggunaan

<AccordionGroup>
  <Accordion title="Konteks Pelanggan">
    Tambahkan catatan tentang preferensi pelanggan, riwayat, atau detail penting yang harus terlihat oleh anggota tim.
  </Accordion>

  <Accordion title="Tindakan Tindak Lanjut">
    Catat tugas yang perlu diselesaikan, seperti mengirim informasi atau menjadwalkan panggilan balik.
  </Accordion>

  <Accordion title="Alasan Eskalasi">
    Dokumentasikan mengapa percakapan dieskalasi ke dukungan manusia untuk pelatihan dan analisis.
  </Accordion>

  <Accordion title="Detail Resolusi">
    Ringkas hasil percakapan untuk referensi di masa mendatang.
  </Accordion>
</AccordionGroup>

## Praktik Terbaik

1. **Jelas dan Ringkas** - Catatan harus mudah dibaca dan dipahami dengan cepat
2. **Sertakan Konteks Waktu** - Referensikan bagian tertentu dari percakapan jika diperlukan
3. **Gunakan Bahasa Profesional** - Catatan mungkin ditinjau oleh beberapa anggota tim
4. **Perbarui Secara Teratur** - Jaga catatan tetap terkini seiring perkembangan percakapan
5. **Hindari Informasi Sensitif** - Jangan sertakan kata sandi, nomor kartu kredit, atau data sensitif lainnya

<Callout type="warning">
  Catatan tidak dapat dihapus setelah dikirim. Pastikan akurasi sebelum mengirim.
</Callout>


## OpenAPI

````yaml openapi.yaml post /v1/note
openapi: 3.0.3
info:
  title: CSKU AI API Publik
  description: >
    CSKU AI API Publik menyediakan endpoint untuk integrasi eksternal.


    API ini memungkinkan pengiriman pesan, pengelolaan percakapan, dan
    pengambilan riwayat pesan.


    ## Autentikasi


    Gunakan header Authorization dengan Secret Key Anda:


    ```

    Authorization: Bearer {secret_key}

    ```


    Dapatkan Secret Key Anda di https://app.csku.ai/settings/secret-key-settings


    ## Batas Rate


    - **100 permintaan per menit** untuk permintaan yang terautentikasi
  version: '1.3'
  contact:
    name: Dukungan CSKU AI
    email: support@csku.ai
    url: https://docs.csku.ai
servers:
  - url: https://api.csku.ai
    description: Server produksi
security:
  - BearerAuth: []
tags:
  - name: Pesan
    description: Endpoint pengelolaan pesan
  - name: Catatan
    description: Endpoint pengelolaan catatan
  - name: Percakapan
    description: Endpoint pengelolaan percakapan
paths:
  /v1/note:
    post:
      tags:
        - Catatan
      summary: Kirim catatan ke percakapan
      description: >-
        Kirim catatan internal untuk referensi percakapan. Catatan tidak
        terlihat oleh pelanggan.
      operationId: sendNote
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendNoteRequest'
            example:
              conversation_id: conv_123456
              note: Pelanggan tertarik dengan paket premium
      responses:
        '200':
          description: Catatan berhasil dikirim
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
              example:
                status: 1
                message: Catatan berhasil dikirim
        '400':
          description: Permintaan Buruk - Field wajib tidak ada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: 0
                error_msg: conversation_id wajib diisi
        '401':
          description: Tidak terotorisasi
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SendNoteRequest:
      type: object
      required:
        - conversation_id
        - note
      properties:
        conversation_id:
          type: string
          description: Pengidentifikasi percakapan yang unik
          example: conv_123456
        note:
          type: string
          description: Konten catatan untuk referensi internal
          example: Pelanggan tertarik dengan paket premium
    SuccessResponse:
      type: object
      properties:
        status:
          type: integer
          description: Kode status (1 = sukses)
          example: 1
        message:
          type: string
          description: Pesan sukses
          example: Sukses
    ErrorResponse:
      type: object
      properties:
        status:
          type: integer
          description: Kode status (0 = error)
          example: 0
        rc:
          type: integer
          description: Kode respons/error
          example: 400
        error_msg:
          type: string
          description: Deskripsi pesan error
          example: Data tidak valid. Mohon periksa kembali parameter dan header
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Secret Key dari dashboard
        (https://app.csku.ai/settings/secret-key-settings)

````