curl -X GET "https://api.whaapy.com/contacts/v1/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wha_TU_API_KEY"
const contactId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/contacts/v1/${contactId}`,
{
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
}
);
const data = await response.json();
console.log(data.contact);
import requests
contact_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.whaapy.com/contacts/v1/{contact_id}',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
$contactId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init("https://api.whaapy.com/contacts/v1/{$contactId}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
{
"contact": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"phone_number": "+5215512345678",
"name": "Juan Pérez",
"email": "juan@email.com",
"avatar_url": "https://example.com/avatar.jpg",
"tags": ["cliente", "premium"],
"custom_fields": {
"company": "Acme Inc",
"role": "CEO",
"contract_value": 50000
},
"external_ids": {
"hubspot": "abc123",
"salesforce": "xyz789"
},
"notes": "Cliente desde 2024. Prefiere contacto por WhatsApp.",
"funnel_stage": {
"id": "stage-uuid",
"name": "Qualified"
},
"source": "whaapy",
"company": "Acme Inc",
"address": "Av. Reforma 123",
"city": "Ciudad de México",
"state": "CDMX",
"postal_code": "06600",
"country": "MX",
"last_contact_at": "2026-01-28T10:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-28T10:00:00Z"
},
"conversations": [
{
"id": "conv-uuid-1",
"status": "active",
"last_message_at": "2026-01-28T10:00:00Z"
},
{
"id": "conv-uuid-2",
"status": "closed",
"last_message_at": "2026-01-15T14:30:00Z"
}
]
}
Contactos
Obtener Contacto
Obtiene los detalles completos de un contacto por su ID
GET
/
contacts
/
v1
/
{id}
curl -X GET "https://api.whaapy.com/contacts/v1/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wha_TU_API_KEY"
const contactId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/contacts/v1/${contactId}`,
{
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
}
);
const data = await response.json();
console.log(data.contact);
import requests
contact_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.whaapy.com/contacts/v1/{contact_id}',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
$contactId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init("https://api.whaapy.com/contacts/v1/{$contactId}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
{
"contact": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"phone_number": "+5215512345678",
"name": "Juan Pérez",
"email": "juan@email.com",
"avatar_url": "https://example.com/avatar.jpg",
"tags": ["cliente", "premium"],
"custom_fields": {
"company": "Acme Inc",
"role": "CEO",
"contract_value": 50000
},
"external_ids": {
"hubspot": "abc123",
"salesforce": "xyz789"
},
"notes": "Cliente desde 2024. Prefiere contacto por WhatsApp.",
"funnel_stage": {
"id": "stage-uuid",
"name": "Qualified"
},
"source": "whaapy",
"company": "Acme Inc",
"address": "Av. Reforma 123",
"city": "Ciudad de México",
"state": "CDMX",
"postal_code": "06600",
"country": "MX",
"last_contact_at": "2026-01-28T10:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-28T10:00:00Z"
},
"conversations": [
{
"id": "conv-uuid-1",
"status": "active",
"last_message_at": "2026-01-28T10:00:00Z"
},
{
"id": "conv-uuid-2",
"status": "closed",
"last_message_at": "2026-01-15T14:30:00Z"
}
]
}
Obtén toda la información de un contacto específico, incluyendo sus conversaciones activas.
Path Parameters
string
required
UUID del contacto
Ejemplos
curl -X GET "https://api.whaapy.com/contacts/v1/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer wha_TU_API_KEY"
const contactId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.whaapy.com/contacts/v1/${contactId}`,
{
headers: { 'Authorization': 'Bearer wha_TU_API_KEY' }
}
);
const data = await response.json();
console.log(data.contact);
import requests
contact_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.get(
f'https://api.whaapy.com/contacts/v1/{contact_id}',
headers={'Authorization': 'Bearer wha_TU_API_KEY'}
)
print(response.json())
$contactId = '550e8400-e29b-41d4-a716-446655440000';
$ch = curl_init("https://api.whaapy.com/contacts/v1/{$contactId}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer wha_TU_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
Respuesta Exitosa
{
"contact": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"phone_number": "+5215512345678",
"name": "Juan Pérez",
"email": "juan@email.com",
"avatar_url": "https://example.com/avatar.jpg",
"tags": ["cliente", "premium"],
"custom_fields": {
"company": "Acme Inc",
"role": "CEO",
"contract_value": 50000
},
"external_ids": {
"hubspot": "abc123",
"salesforce": "xyz789"
},
"notes": "Cliente desde 2024. Prefiere contacto por WhatsApp.",
"funnel_stage": {
"id": "stage-uuid",
"name": "Qualified"
},
"source": "whaapy",
"company": "Acme Inc",
"address": "Av. Reforma 123",
"city": "Ciudad de México",
"state": "CDMX",
"postal_code": "06600",
"country": "MX",
"last_contact_at": "2026-01-28T10:00:00Z",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-28T10:00:00Z"
},
"conversations": [
{
"id": "conv-uuid-1",
"status": "active",
"last_message_at": "2026-01-28T10:00:00Z"
},
{
"id": "conv-uuid-2",
"status": "closed",
"last_message_at": "2026-01-15T14:30:00Z"
}
]
}
Campos del Contacto
| Campo | Tipo | Descripción |
|---|---|---|
id | string | UUID único del contacto |
phone_number | string | Número en formato E.164 |
name | string | Nombre completo |
email | string | Email de contacto |
avatar_url | string | URL de imagen de perfil |
tags | string[] | Array de tags asignados |
custom_fields | object | Campos personalizados (clave-valor) |
external_ids | object | IDs de CRMs externos |
notes | string | Notas internas |
funnel_stage | object | Etapa actual del funnel |
source | string | Origen del contacto |
company | string | Nombre de empresa |
last_contact_at | string | Fecha de última interacción |
created_at | string | Fecha de creación |
updated_at | string | Fecha de última actualización |
Errores
{
"error": "not_found",
"message": "Contacto no encontrado"
}
{
"error": "validation_error",
"message": "ID de contacto inválido"
}
Próximos Pasos
Actualizar Contacto
Modificar datos del contacto
Eliminar Contacto
Eliminar contacto (soft delete)
Fusionar Contactos
Combinar duplicados
Enviar Mensaje
Enviar mensaje al contacto
Was this page helpful?