Skip to main content

​
Conversaciones

Las conversaciones representan hilos de chat con tus contactos. Cada conversación está vinculada a un contacto y contiene todo el historial de mensajes.

Listar Conversaciones

Obtén todas las conversaciones con filtros avanzados

Obtener Conversación

Detalles de una conversación específica

Buscar por Teléfono

Encuentra una conversación por número

Historial de Mensajes

Obtén todos los mensajes de una conversación

Cerrar Conversación

Cierra una conversación activa

Control de IA

Activa, desactiva o pausa la IA por conversación

​
Scopes requeridos

EndpointScope
Lectura (GET)conversations:read
Escritura (POST/PATCH)conversations:write
Mensajesmessages:read

​
Estados de conversación

EstadoDescripción
activeConversación abierta y activa
closedCerrada manualmente o por inactividad
archivedArchivada (oculta de la bandeja principal)

​
Casos de uso comunes

Usa GET /conversations/v1 con filtros de fecha para obtener conversaciones nuevas y sincronizarlas con tu CRM.
curl "https://api.whaapy.com/conversations/v1?filters=%7B%22updatedFilter%22%3A%22today%22%7D" \
  -H "Authorization: Bearer wha_xxxxx"
Filtra por mensajes no leídos y estado activo para encontrar conversaciones pendientes.
curl "https://api.whaapy.com/conversations/v1?filters=%7B%22statusFilter%22%3A%22unread%22%7D" \
  -H "Authorization: Bearer wha_xxxxx"
Usa POST /conversations/v1/:id/close después de resolver un ticket en tu sistema.
curl -X POST "https://api.whaapy.com/conversations/v1/uuid/close" \
  -H "Authorization: Bearer wha_xxxxx"
Cuando un agente humano toma el control, pausa la IA temporalmente.
curl -X POST "https://api.whaapy.com/conversations/v1/uuid/ai/pause" \
  -H "Authorization: Bearer wha_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"duration": 30}'

​
Próximos pasos

Enviar Mensajes

Envía mensajes a conversaciones existentes

Webhooks

Recibe notificaciones de nuevos mensajes