Ir al contenido

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 citandoSí
ReenviarSí
Reaccionar, marcar leído, borrarNo

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 ​

CampoQué es
reply_toEl msg_ que cita este mensaje, o null.
forwardedtrue si se envió con la marca "Reenviado".
deleted_atCuándo se borró para todos, o null. El contenido se conserva.