curl -X GET "https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wha_xxxxx"
const conversationId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/conversations/v1/${conversationId}`,
{
headers: { 'Authorization': 'Bearer wha_xxxxx' }
}
);
const data = await response.json();
import requests
conversation_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.whaapy.com/conversations/v1/{conversation_id}',
headers={'Authorization': 'Bearer wha_xxxxx'}
)
data = response.json()
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer wha_xxxxx"
],
]);
$response = curl_exec($curl);
$data = json_decode($response, true);
{
"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"
}
}
Conversaciones
Obtener Conversación
Obtén los detalles de una conversación específica
GET
/
conversations
/
v1
/
{id}
curl -X GET "https://api.whaapy.com/conversations/v1/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wha_xxxxx"
const conversationId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/conversations/v1/${conversationId}`,
{
headers: { 'Authorization': 'Bearer wha_xxxxx' }
}
);
const data = await response.json();
import requests
conversation_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.whaapy.com/conversations/v1/{conversation_id}',
headers={'Authorization': 'Bearer wha_xxxxx'}
)
data = response.json()
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer wha_xxxxx"
],
]);
$response = curl_exec($curl);
$data = json_decode($response, true);
{
"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
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"
const conversationId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/conversations/v1/${conversationId}`,
{
headers: { 'Authorization': 'Bearer wha_xxxxx' }
}
);
const data = await response.json();
import requests
conversation_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.whaapy.com/conversations/v1/{conversation_id}',
headers={'Authorization': 'Bearer wha_xxxxx'}
)
data = response.json()
$conversationId = '550e8400-e29b-41d4-a716-446655440000';
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.whaapy.com/conversations/v1/{$conversationId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer wha_xxxxx"
],
]);
$response = curl_exec($curl);
$data = json_decode($response, true);
{
"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
| Campo | Tipo | Descripción |
|---|---|---|
id | string | UUID de la conversación |
phoneNumber | string | Número de WhatsApp del contacto |
contactName | string | Nombre del contacto |
profilePictureUrl | string | URL de la foto de perfil |
lastMessageAt | string | Fecha del último mensaje |
unreadCount | number | Mensajes no leídos |
status | string | active, closed, archived |
settings.aiEnabled | boolean | Si la IA está activa |
settings.aiMode | string | auto o manual |
settings.aiPausedUntil | string | Fecha hasta la que la IA está pausada |
contact | object | Datos completos del contacto |
assignedTo | object | Agente asignado (null si no hay) |
stats.totalMessages | number | Total de mensajes |
stats.unreadMessages | number | Mensajes sin leer |
Errores
{
"error": "Not found",
"message": "Conversación no encontrada"
}
Was this page helpful?