Skip to main content

​
Indicador de Digitando / Gravando

Mostra ao contato um indicador ao vivo de “digitando” ou “gravando” sem enviar mensagem. O indicador some quando uma mensagem é enviada, ou após um timeout do provedor (~25s na Meta).
O “digitando” também é mostrado automaticamente antes de todo envio conversacional (em números Meta e Evolution). Use este endpoint apenas para mostrar o indicador de forma independente de um envio.

​
Cabeçalhos

  • Content-Type: application/json
  • x-api-key: ps_... (ou x-api-key-id: <api_key_id>) — uma chave com escopo de número

​
Corpo

​
string
obrigatório
Telefone do contato em E.164 ou só dígitos — a quem mostrar o indicador.
​
string
padrão:"typing"
typing (padrão), recording ou paused.

​
Exemplo

​
Resposta (200)

​
boolean
true quando o indicador foi despachado ao contato.
​
string
META ou EVOLUTION.
​
string
O indicador realmente mostrado. A Meta rebaixa recording para typing.
​
string
Presente quando o indicador foi adaptado ou não pôde ser mostrado (ex.: conversa Meta sem mensagem recebida para ancorar).

​
Comportamento por provedor

A Meta Cloud API não tem endpoint de presença próprio. O “digitando” é emitido como um recibo de leitura + indicador na última mensagem recebida do contato, então em números Meta:
  • precisa de uma mensagem recebida recente para ancorar (senão sent:false);
  • não existe variante “gravando” — recording aparece como typing;
  • paused é no-op.
Números Evolution (Pilot Status web / GO) relaiam composing / recording / paused nativamente.

​
Erros comuns