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

# Digitando

## Descrição

Envia o indicador de **"digitando…"** (ou **"gravando áudio…"**) para um contato, deixando o atendimento mais natural e humano. O indicador some sozinho após alguns segundos, ao enviar a próxima mensagem, ou quando você envia o estado `paused`.

### Parâmetros

<ParamField body="appkey" type="string" required>
  Chave de aplicação.
</ParamField>

<ParamField body="authkey" type="string" required>
  Chave de autenticação do usuário.
</ParamField>

<ParamField body="to" type="string" required>
  Número do destinatário, com DDI e DDD.
</ParamField>

<ParamField body="presence" type="string" required>
  Estado a exibir:

  * `composing` — "digitando…"
  * `recording` — "gravando áudio…"
  * `paused` — parar o indicador
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://chatbot.menuia.com/api/create-message \
    -H "Content-Type: application/json" \
    -d '{
      "appkey": "SEU_APPKEY",
      "authkey": "SUA_AUTHKEY",
      "to": "5511999999999",
      "presence": "composing"
    }'
  ```

  ```javascript Node.js theme={null}
  await fetch("https://chatbot.menuia.com/api/create-message", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      appkey: "SEU_APPKEY",
      authkey: "SUA_AUTHKEY",
      to: "5511999999999",
      presence: "composing"
    })
  });
  ```

  ```python Python theme={null}
  import requests

  requests.post("https://chatbot.menuia.com/api/create-message", json={
      "appkey": "SEU_APPKEY",
      "authkey": "SUA_AUTHKEY",
      "to": "5511999999999",
      "presence": "composing"
  })
  ```

  ```php PHP theme={null}
  Http::post("https://chatbot.menuia.com/api/create-message", [
      "appkey"   => "SEU_APPKEY",
      "authkey"  => "SUA_AUTHKEY",
      "to"       => "5511999999999",
      "presence" => "composing",
  ]);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Sucesso theme={null}
  {
    "status": 200,
    "message": "Presença enviada."
  }
  ```
</ResponseExample>