Apariencia
Responder, reaccionar, leer, borrar y reenviar
Acciones sobre un mensaje guardado (msg_...), enviado o recibido. Todas necesitan el scope messages:send y que la instancia esté conectada. El mensaje debe haber llegado a WhatsApp; si sigue en cola o falló, la respuesta es 409 MESSAGE_NOT_SENT.
| Acción | ¿Cuenta como mensaje? |
|---|---|
| Responder citando | Sí |
| Reenviar | Sí |
| Reaccionar, marcar leído, borrar | No |
Responder citando un mensaje
Agrega reply_to al envío normal, con el id de un mensaje del mismo chat (misma instancia y mismo número o grupo). Funciona igual con texto y multimedia.
bash
curl -X POST "https://zappio.cloud/api/v1/messages" \
-H "Authorization: Bearer $ZAPPIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"instance": "ins_...", "to": "+52 1 55 0000 0000", "type": "text", "text": "Sí, mañana sale.", "reply_to": "msg_..."}'El mensaje enviado trae "reply_to": "msg_...". Si el mensaje citado es de otro chat la respuesta es 422 MESSAGE_NOT_IN_CHAT; si se borró para todos, 409 MESSAGE_DELETED.
Reaccionar
bash
curl -X POST "https://zappio.cloud/api/v1/messages/msg_.../reaction" \
-H "Authorization: Bearer $ZAPPIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"emoji": "👍"}'json
{ "data": { "message_id": "msg_...", "emoji": "👍" } }Un solo emoji (con tono de piel o combinados también). Reaccionar otra vez reemplaza la reacción anterior. Para quitarla:
bash
curl -X DELETE "https://zappio.cloud/api/v1/messages/msg_.../reaction" \
-H "Authorization: Bearer $ZAPPIO_API_KEY"Marcar como leído
Pone las palomitas azules en un mensaje que escribió el contacto (si la configuración de privacidad del número las muestra). Con "played": true, en una nota de voz, la marca además como escuchada (micrófono azul).
bash
curl -X POST "https://zappio.cloud/api/v1/messages/msg_.../read" \
-H "Authorization: Bearer $ZAPPIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"played": true}'json
{ "data": { "message_id": "msg_...", "read": true, "played": true } }Borrar para todos
Solo mensajes que envió tu número y dentro del plazo que permite WhatsApp (unos 2.5 días).
bash
curl -X DELETE "https://zappio.cloud/api/v1/messages/msg_..." \
-H "Authorization: Bearer $ZAPPIO_API_KEY"La respuesta es el mensaje con deleted_at. ZAPPIO conserva su contenido. Borrarlo otra vez no hace nada.
Reenviar
Envía una copia de un mensaje guardado (su texto, o su archivo y pie de foto) a otro chat de la misma instancia, con la marca "Reenviado" de WhatsApp. Es un mensaje nuevo: queda en cola (202), cuenta como mensaje y se sigue igual que cualquier envío. Acepta Idempotency-Key.
bash
curl -X POST "https://zappio.cloud/api/v1/messages/msg_.../forward" \
-H "Authorization: Bearer $ZAPPIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to": "+52 1 722 555 0000"}'El mensaje nuevo trae "forwarded": true. Un archivo solo se puede reenviar si ZAPPIO lo tiene guardado (media.available: true); si no, la respuesta es 404 MEDIA_NOT_AVAILABLE.
Campos nuevos del mensaje
| Campo | Qué es |
|---|---|
reply_to | El msg_ que cita este mensaje, o null. |
forwarded | true si se envió con la marca "Reenviado". |
deleted_at | Cuándo se borró para todos, o null. El contenido se conserva. |