Enviar mensagens
Marcar como lida
Marque uma mensagem recebida como lida com POST /v1/messages/{id}/read e, se quiser, mostre o indicador de digitação.
POST /v1/messages/{id}/read marca como lida uma mensagem que o contato mandou. Com typing: true, mostra também o indicador de “digitando”.
Antes de começar
Seção intitulada “Antes de começar”- Uma chave de API com a permissão
send. - O
id(msg_…) da mensagem recebida, que vem no eventomessage.received.
Marcar como lida
Seção intitulada “Marcar como lida”curl -X POST https://api.messajo.com/v1/messages/msg_.../read \ -H "Authorization: Bearer $MESSAJO_API_KEY"Com o indicador de digitação:
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \ -H "Authorization: Bearer $MESSAJO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "typing": true }'import { Messajo } from "@messajo/sdk";
const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });
await messajo.messages.markRead("msg_...");O método do SDK não recebe typing. Para mostrar “digitando”, chame a API REST (aba cURL) ou mande typing: true no próximo envio.
Configurações do nó HTTP Request do n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages/msg_.../read - Autenticação: Generic Credential Type, depois Header Auth. Nome:
Authorization; Valor:Bearer mj_... - Cabeçalhos: ative Send Headers e adicione
Idempotency-Key(um valor único por item) - Corpo: ative Send Body; Body Content Type: JSON; Specify Body: Using JSON
{ "typing": true}Substitua mj_... pela sua chave de API.
A resposta traz o id e a confirmação:
{ "id": "msg_...", "read": true }| Campo | Descrição |
|---|---|
id (caminho) |
Id msg_… da mensagem recebida. |
typing (corpo, opcional) |
true mostra “digitando”. Padrão false. |
Por canal
Seção intitulada “Por canal”- WhatsApp: o indicador de digitação sempre marca a mensagem como lida.
- Instagram:
typing: truemostra “digitando” antes do envio ePOST /v1/messages/{id}/readmarca a conversa como vista. - Messenger: usa o mesmo motor do Instagram, veja Mensagens.
O typing gasta uma ficha do balde do número (veja Limites).
Erros comuns
Seção intitulada “Erros comuns”not_found(404): oidnão existe.connection_rate_limited(429): sem ficha no balde. Espere oRetry-Aftere repita.