Enviar mensajes
Marcar como leído
Marca un mensaje recibido como leído con POST /v1/messages/{id}/read y, si quieres, muestra el indicador de escritura.
POST /v1/messages/{id}/read marca como leído un mensaje que envió el contacto. Con typing: true, muestra además el indicador de “escribiendo”.
Antes de empezar
Sección titulada «Antes de empezar»- Una clave de API con el permiso
send. - El
id(msg_…) del mensaje recibido, que llega en el eventomessage.received.
Marcar como leído
Sección titulada «Marcar como leído»curl -X POST https://api.messajo.com/v1/messages/msg_.../read \ -H "Authorization: Bearer $MESSAJO_API_KEY"Con el indicador de escritura:
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_...");El método del SDK no recibe typing. Para mostrar “escribiendo”, llama a la API REST (pestaña cURL) o envía typing: true en el siguiente envío.
Ajustes del nodo HTTP Request de n8n
- Método:
POST - URL:
https://api.messajo.com/v1/messages/msg_.../read - Autenticación: Generic Credential Type, luego Header Auth. Nombre:
Authorization; Valor:Bearer mj_... - Encabezados: activa Send Headers y añade
Idempotency-Key(un valor único por ítem) - Cuerpo: activa Send Body; Body Content Type: JSON; Specify Body: Using JSON
{ "typing": true}Sustituye mj_... por tu clave de API.
La respuesta trae el id y la confirmación:
{ "id": "msg_...", "read": true }| Campo | Descripción |
|---|---|
id (ruta) |
Id msg_… del mensaje recibido. |
typing (cuerpo, opcional) |
true muestra “escribiendo”. Por defecto false. |
Por canal
Sección titulada «Por canal»- WhatsApp: el indicador de escritura siempre marca el mensaje como leído.
- Instagram:
typing: truemuestra “escribiendo” antes del envío yPOST /v1/messages/{id}/readmarca la conversación como vista. - Messenger: usa el mismo motor que Instagram, consulta Mensajes.
typing gasta una ficha del balde del número (consulta Límites).
Errores comunes
Sección titulada «Errores comunes»not_found(404): elidno existe.connection_rate_limited(429): sin fichas en el balde. Espera elRetry-Aftery repite.