Skip to main content
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"
{
  "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

id
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"

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

CampoTipoDescripción
idstringUUID único del contacto
phone_numberstringNúmero en formato E.164
namestringNombre completo
emailstringEmail de contacto
avatar_urlstringURL de imagen de perfil
tagsstring[]Array de tags asignados
custom_fieldsobjectCampos personalizados (clave-valor)
external_idsobjectIDs de CRMs externos
notesstringNotas internas
funnel_stageobjectEtapa actual del funnel
sourcestringOrigen del contacto
companystringNombre de empresa
last_contact_atstringFecha de última interacción
created_atstringFecha de creación
updated_atstringFecha de última actualización

Errores

{
  "error": "not_found",
  "message": "Contacto no encontrado"
}
{
  "error": "validation_error",
  "message": "ID de contacto inválido"
}

Próximos Pasos