> ## Documentation Index
> Fetch the complete documentation index at: https://docs.horneross.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts API

> Gestionar contactos y leads capturados por tus agentes.

La API de Contacts te permite gestionar los contactos y leads capturados automáticamente por tus agentes de Horneross.

## Endpoints disponibles

<CardGroup cols={2}>
  <Card title="Listar contactos" icon="users" href="/developers/api/contacts/list">
    Obtener todos los contactos con paginación y búsqueda.
  </Card>

  <Card title="Crear contacto" icon="user-plus" href="/developers/api/contacts/create">
    Crear un nuevo contacto manualmente.
  </Card>
</CardGroup>

## Captura automática de contactos

Los contactos se capturan automáticamente cuando:

1. **Tool Lead Capture**: El agente ejecuta la herramienta de captura de leads
2. **Form Submission**: Un usuario completa un formulario con email/teléfono
3. **WhatsApp**: Se recibe un mensaje de un número nuevo
4. **Instagram**: Se recibe un mensaje de un usuario de Instagram

### Datos capturados por canal

| Canal       | Email        | Teléfono     | Nombre         | Instagram ID |
| ----------- | ------------ | ------------ | -------------- | ------------ |
| Chat API    | Si se provee | Si se provee | Si se provee   | -            |
| WhatsApp    | -            | Automático   | Si se comparte | -            |
| Instagram   | -            | -            | Username       | Automático   |
| Formularios | Automático   | Automático   | Automático     | -            |

## Errores comunes

| Código | Error          | Causa                      | Solución                       |
| ------ | -------------- | -------------------------- | ------------------------------ |
| `400`  | `BAD_REQUEST`  | Email mal formateado       | Verificá el formato del email  |
| `401`  | `UNAUTHORIZED` | API key inválida           | Verificá tu API key            |
| `404`  | `NOT_FOUND`    | conversationId inexistente | Verificá el ID de conversación |