Skip to main content
GET
/
conversations
/
v1
/
{id}
curl -X GET "https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer wha_xxxxx"
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "phoneNumber": "+5215512345678",
    "contactName": "Juan Pérez",
    "profilePictureUrl": "https://...",
    "lastMessageAt": "2026-01-29T10:30:00Z",
    "unreadCount": 2,
    "status": "active",
    "settings": {
      "aiEnabled": true,
      "aiMode": "auto",
      "aiPausedUntil": null,
      "pausedBy": null
    },
    "contact": {
      "id": "uuid",
      "phoneNumber": "+5215512345678",
      "name": "Juan Pérez",
      "email": "juan@ejemplo.com",
      "avatarUrl": null,
      "tags": ["cliente-nuevo", "vip"],
      "funnelStage": {
        "id": "uuid",
        "name": "Calificado",
        "color": "#10B981",
        "position": 2
      }
    },
    "assignedTo": {
      "agentId": "uuid",
      "agentName": "María García",
      "agentEmail": "maria@empresa.com",
      "assignedAt": "2026-01-28T12:00:00Z",
      "assignmentMethod": "manual"
    },
    "stats": {
      "totalMessages": 45,
      "unreadMessages": 2
    },
    "createdAt": "2026-01-28T08:00:00Z",
    "updatedAt": "2026-01-29T10:30:00Z"
  }
}

Parámetros de Path

id
string
required
UUID de la conversación
curl -X GET "https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer wha_xxxxx"
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "phoneNumber": "+5215512345678",
    "contactName": "Juan Pérez",
    "profilePictureUrl": "https://...",
    "lastMessageAt": "2026-01-29T10:30:00Z",
    "unreadCount": 2,
    "status": "active",
    "settings": {
      "aiEnabled": true,
      "aiMode": "auto",
      "aiPausedUntil": null,
      "pausedBy": null
    },
    "contact": {
      "id": "uuid",
      "phoneNumber": "+5215512345678",
      "name": "Juan Pérez",
      "email": "juan@ejemplo.com",
      "avatarUrl": null,
      "tags": ["cliente-nuevo", "vip"],
      "funnelStage": {
        "id": "uuid",
        "name": "Calificado",
        "color": "#10B981",
        "position": 2
      }
    },
    "assignedTo": {
      "agentId": "uuid",
      "agentName": "María García",
      "agentEmail": "maria@empresa.com",
      "assignedAt": "2026-01-28T12:00:00Z",
      "assignmentMethod": "manual"
    },
    "stats": {
      "totalMessages": 45,
      "unreadMessages": 2
    },
    "createdAt": "2026-01-28T08:00:00Z",
    "updatedAt": "2026-01-29T10:30:00Z"
  }
}

Campos de respuesta

CampoTipoDescripción
idstringUUID de la conversación
phoneNumberstringNúmero de WhatsApp del contacto
contactNamestringNombre del contacto
profilePictureUrlstringURL de la foto de perfil
lastMessageAtstringFecha del último mensaje
unreadCountnumberMensajes no leídos
statusstringactive, closed, archived
settings.aiEnabledbooleanSi la IA está activa
settings.aiModestringauto o manual
settings.aiPausedUntilstringFecha hasta la que la IA está pausada
contactobjectDatos completos del contacto
assignedToobjectAgente asignado (null si no hay)
stats.totalMessagesnumberTotal de mensajes
stats.unreadMessagesnumberMensajes sin leer

Errores

{
  "error": "Not found",
  "message": "Conversación no encontrada"
}