API de WhatsApp y CRM
POST/devices/{deviceId}/readchats

Leer mensajes del chat

Informa bajo demanda de los mensajes no leídos de uno o varios chats como mensajes leídos, simulando el comportamiento de un usuario con el doble check azul tras leer los mensajes.

API de WhatsApp y CRM
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
POST https://api.getincloud.ai/v1/devices/{deviceId}/readchats

Informa bajo demanda de los mensajes no leídos de uno o varios chats como mensajes leídos, simulando el comportamiento de un usuario con el doble check azul tras leer los mensajes.

Al llamar a este endpoint, puedes marcar arbitrariamente como leídos todos los mensajes no leídos de uno o varios chats.

Importante: este endpoint de la API puede tardar hasta 90 segundos en responder, por lo que te recomendamos aumentar la tolerancia de tiempo de espera (timeout) en tu cliente HTTP.

Como alternativa, puedes informar los mensajes leídos por chat cada vez que envíes un mensaje a un usuario o grupo de destino, simplemente añadiendo el campo JSON sendReadAck: true en el cuerpo de la solicitud a la API.

Para más detalles, consulta la documentación del [endpoint Messages > Send message](#operation/createMessage).

Nota: si has desactivado la confirmación de lectura en WhatsApp Ajustes > Cuenta > Privacidad, esta acción no tendrá efecto.


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 prueba la API en el probador 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.

Cuerpo de la petición

CampoTipoObligatorioDescripción
chatsarray<string>SíIDs de chat con la notación nativa de WhatsApp o número de teléfono internacional del chat. Por ejemplo: 1234567890, 442384927503@c.us, 0482349343-232322332@g.us o 120000000000000000@g.us

Respuestas

CódigoDescripción
200Resultados con pares clave-valor
400Datos de consulta o de cuerpo de la solicitud no válidos
401Acceso no autorizado por token de API no válido o caducado
403Falta el token de API requerido
404Número no encontrado
409Conflicto
429Demasiadas solicitudes. Inténtalo de nuevo más tarde
500Error inesperado
501No implementado
503La sesión del dispositivo no está disponible actualmente
// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Notify multiple chats as read by the user
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/readchats \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"chats":["1234567890","1234567890@c.us","1234567890-100000000@g.us","120000000000000000@g.us"]}'
AnteriorIniciar sesiónSiguienteListar etiquetas
¿Te sirvió esta página?