Eliminar mensaje

Elimina un mensaje enviado o recibido por su ID en la sesión de dispositivo vinculado de WhatsApp.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

DELETE https://api.getincloud.ai/v1/chat/{deviceId}/messages/{messageWid}

Elimina un mensaje enviado o recibido por su ID en la sesión de dispositivo vinculado de WhatsApp.

Nota: por defecto, el mensaje solo se elimina localmente en tu número de WhatsApp.

Si deseas revocar y eliminar el mensaje en el número de WhatsApp del destinatario, debes especificar revoke=true como parámetro de consulta en la URL.

Solo los mensajes salientes pueden revocarse dentro de la semana posterior a su entrega.

De lo contrario, la revocación fallará, a menos que especifiques el parámetro de consulta force=true en la URL para eliminar el mensaje solo para ti.

Sin embargo, el destinatario del mensaje seguirá teniendo acceso a él.

Este endpoint requiere que la sesión del número de WhatsApp esté en línea; de lo contrario, devolverá un error.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y juega con el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Parámetros

Campo	Dónde	Tipo	Obligatorio	Descripción
`clean`	query	boolean	No	Elimina el cuadro de información de eliminación del mensaje de la lista de chats. Esto solo afecta localmente a la cuenta de WhatsApp del remitente, no a la del destinatario. `default: False`
`force`	query	boolean	No	Fuerza la eliminación local del mensaje aunque no pueda revocarse en el lado del destinatario. Un mensaje puede eliminarse en el lado del destinatario dentro de la hora posterior a su entrega. `default: False`
`revoke`	query	boolean	No	Revoca y elimina el mensaje para todas las demás personas que lo recibieron. Ten en cuenta que un mensaje solo puede revocarse durante los primeros 60 minutos después de su creación. De lo contrario, el mensaje solo se eliminará localmente en tu número de WhatsApp, pero no en el lado del destinatario. `default: False`

Respuestas

Código	Descripción
`200`	Mensaje eliminado
`400`	Solicitud no válida
`401`	No autorizado - Token de API no válido o ausente
`403`	Faltan los permisos requeridos
`404`	Mensaje no encontrado
`409`	Ya eliminado o no se puede revocar el mensaje
`429`	Demasiadas solicitudes - Inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	La sesión del número no está en línea

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Delete device message
curl --request DELETE \
  --url https://api.getincloud.ai/v1/chat/{deviceId}/messages/{messageWid} \
  --header 'Token: <api token goes here>'

AnteriorEliminar estado de usuario SiguienteEliminar nota

¿Te sirvió esta página?