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

# Indicador de digitação

> Mostre o aviso de digitando enquanto a resposta é preparada.

Exibe o aviso de **"digitando…"** na conversa, avisando o cliente de que a resposta está sendo preparada. É útil quando o atendimento passa por um bot, uma consulta demorada ou a fila de um atendente.

O indicador é enviado **junto com a marcação de leitura**, na mesma requisição: é o corpo de [Marcar como lida](https://developers.datafyapi.com.br/api-reference/whatsapp/recursos/marcar-como-lida.md) com o objeto `typing_indicator`.

```json theme={null}
{
  "messaging_product": "whatsapp",
  "status": "read",
  "message_id": "wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=",
  "typing_indicator": { "type": "text" }
}
```

A resposta é `{ "success": true }`. O `message_id` é o `wamid` da mensagem do cliente, que chega no [webhook](https://developers.datafyapi.com.br/api-reference/whatsapp/webhooks/eventos/mensagens.md) em `messages[].id`.

## Quanto tempo o aviso fica

O aviso some **quando você envia a resposta** ou **depois de 25 segundos**, o que acontecer primeiro.

> [!TIP]
>
> Envie o indicador só quando a resposta vier logo em seguida. Mostrar "digitando…" sem responder deixa o cliente esperando à toa, e a Meta desaconselha esse uso.

Para respostas que demoram mais de 25 segundos, envie o indicador de novo antes de o prazo acabar, sempre com o `message_id` da mensagem do cliente.

> [!WARNING]
>
> Vale o mesmo prazo de Marcar como lida: a mensagem precisa ter sido recebida nos **últimos 30 dias**. Fora disso, a Meta responde com o erro `131009`.

Veja mais detalhes na [documentação de indicadores de digitação da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/typing-indicators).


## OpenAPI

````yaml api-reference/whatsapp/specs/indicador-de-digitacao.json POST /v1/{phone_number_id}/messages
openapi: 3.1.0
info:
  title: Datafy API — Indicador de digitação
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/{phone_number_id}/messages:
    post:
      summary: Indicador de digitação
      description: >-
        Exibe o aviso de "digitando…" para o cliente. É enviado junto com a
        marcação de leitura, na mesma requisição.
      operationId: indicadorDeDigitacao
      parameters:
        - name: phone_number_id
          in: path
          required: true
          schema:
            type: string
          description: ID do número que recebeu a mensagem. Descubra com `GET /me`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IndicadorDigitacao'
            example:
              messaging_product: whatsapp
              status: read
              message_id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=
              typing_indicator:
                type: text
      responses:
        '200':
          description: Indicador exibido e mensagem marcada como lida.
          content:
            application/json:
              example:
                success: true
        '400':
          description: ID de mensagem inválido ou fora do prazo de 30 dias.
          content:
            application/json:
              example:
                error:
                  message: (#131009) Parameter value is not valid
                  type: OAuthException
                  code: 131009
                  fbtrace_id: AbCdEfGhIjK
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  schemas:
    IndicadorDigitacao:
      type: object
      required:
        - messaging_product
        - status
        - message_id
        - typing_indicator
      properties:
        messaging_product:
          type: string
          enum:
            - whatsapp
          default: whatsapp
          example: whatsapp
          description: Sempre `whatsapp`.
        status:
          type: string
          enum:
            - read
          default: read
          example: read
          description: >-
            Sempre `read`. O indicador de digitação é enviado junto com a
            marcação de leitura.
        message_id:
          type: string
          example: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjJBQjE=
          description: >-
            ID (`wamid`) da mensagem recebida, encontrado no webhook em
            `messages[].id`.
        typing_indicator:
          type: object
          required:
            - type
          description: Aviso de digitação exibido para o cliente.
          properties:
            type:
              type: string
              enum:
                - text
              default: text
              example: text
              description: Sempre `text`.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token gerado no painel da Datafy ao criar o canal. Formato:
        `sk_live_xxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.