> ## 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.

# Tandai Percakapan Membutuhkan Manusia

> Tandai percakapan untuk menunjukkan bahwa diperlukan bantuan manusia.

<Callout type="info">
  Endpoint ini memberi sinyal kepada tim Anda bahwa percakapan membutuhkan perhatian manusia. Berguna ketika AI tidak dapat menangani permintaan.
</Callout>

## Kapan Menggunakan Endpoint Ini

<AccordionGroup>
  <Accordion title="Pertanyaan Kompleks">
    Ketika pelanggan memiliki pertanyaan kompleks yang memerlukan penilaian manusia atau pengetahuan khusus.
  </Accordion>

  <Accordion title="Sengketa Tagihan">
    Untuk masalah terkait tagihan yang memerlukan tinjauan akun atau otorisasi.
  </Accordion>

  <Accordion title="Hal Sensitif">
    Ketika berurusan dengan informasi pribadi atau sensitif yang memerlukan kebijaksanaan manusia.
  </Accordion>

  <Accordion title="Permintaan Pelanggan">
    Ketika pelanggan secara eksplisit meminta untuk berbicara dengan agen manusia.
  </Accordion>

  <Accordion title="Masalah Berulang">
    Ketika masalah yang sama terjadi beberapa kali, menunjukkan kebutuhan intervensi manusia.
  </Accordion>
</AccordionGroup>

## Praktik Terbaik

1. **Gunakan dengan Bijaksana** - Hanya tandai percakapan yang benar-benar membutuhkan perhatian manusia
2. **Tambahkan Konteks** - Kirim catatan dengan konteks mengapa percakapan ditandai
3. **Pantau Backlog** - Periksa secara teratur jumlah percakapan yang membutuhkan perhatian manusia
4. **Atur Prioritas** - Terapkan sistem untuk memprioritaskan percakapan yang ditandai untuk intervensi manusia

<Callout type="warning">
  Penggunaan berlebihan endpoint ini dapat membebani tim dukungan Anda. Gunakan hanya jika diperlukan. Tindakan ini dapat dibatalkan melalui dashboard, tetapi tidak melalui API.
</Callout>


## OpenAPI

````yaml openapi.yaml post /v1/conversation/need-human
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/conversation/need-human:
    post:
      tags:
        - Percakapan
      summary: Tandai percakapan membutuhkan intervensi manusia
      description: Tandai percakapan untuk menunjukkan bahwa diperlukan bantuan manusia.
      operationId: markNeedHuman
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MarkNeedHumanRequest'
            example:
              conversation_id: conv_123456
      responses:
        '200':
          description: Percakapan berhasil ditandai
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
              example:
                status: 1
                message: Percakapan ditandai membutuhkan bantuan manusia
        '400':
          description: Permintaan Buruk - conversation_id 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:
    MarkNeedHumanRequest:
      type: object
      required:
        - conversation_id
      properties:
        conversation_id:
          type: string
          description: Pengidentifikasi percakapan yang unik
          example: conv_123456
    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)

````