Typing / Recording Indicator

POST https://pilotstatus.com.br/v1/messages/typing

Shows the contact a live “typing” (digitando) or “recording” (gravando) indicator without sending a message. The indicator auto-clears when a message is sent, or after a provider timeout (~25s on Meta).

Typing is also shown automatically before every conversational send (on both Meta and Evolution numbers). Use this endpoint only to show the indicator independently of a send.

Headers

Content-Type: application/json
x-api-key: ps_... (or x-api-key-id: <api_key_id>) — a number-scoped key

Body

string

required

Destination phone in E.164 or bare digits — the contact to show the indicator to.

string

default:"typing"

typing (default), recording, or paused.

Example

curl -X POST "https://pilotstatus.com.br/v1/messages/typing" \
  -H "Content-Type: application/json" \
  -H "x-api-key: ps_your_key_here" \
  -d '{ "to": "5511999999999", "state": "typing" }'

Response (200)

{ "ok": true, "sent": true, "provider": "META", "effectiveState": "typing" }

boolean

true when the indicator was dispatched to the contact.

string

META or EVOLUTION.

string

The indicator actually shown. Meta downgrades recording to typing.

string

Present when the indicator was adapted or could not be shown (e.g. a Meta conversation with no inbound message to attach to).

Provider behavior

Meta Cloud API has no standalone presence endpoint. Typing is emitted as a read receipt + typing indicator on the contact’s last inbound message, so on Meta numbers:

it requires a recent inbound message to attach to (otherwise sent:false);
there is no “recording” variant — recording is shown as typing;
paused is a no-op.

Evolution (Pilot Status web / GO) numbers relay composing / recording / paused natively.

Common errors

Status	Meaning
`400`	Invalid JSON, invalid `state`, or the key is not bound to a number (`code: NUMBER_NOT_FOUND`)
`401`	Missing/invalid API key header (`x-api-key` / `x-api-key-id`)
`403`	A tenant-scoped key used on a number-scoped endpoint
`404`	No conversation with `to` (`code: CONVERSATION_NOT_FOUND`)

Overview

Messaging

Templates

Numbers

Conversations & Data

Webhooks

Voice Calls

API Layer

Account & Billing

Branding & Embedding

POST /v1/messages/typing — Typing / Recording Indicator

Typing / Recording Indicator

Headers

Body

Example

Response (200)

Provider behavior

Common errors

​Typing / Recording Indicator

​Headers

​Body

​Example

​Response (200)

​Provider behavior

​Common errors

Typing / Recording Indicator

Headers

Body

Example

Response (200)

Provider behavior

Common errors