Obtén todos tus clientes, rápido y fácil

• 🔄 Sincronizar contactos de forma incremental

• ⚡ Consultas ultrarrápidas gracias a índices optimizados

• 📊 Integrar con pipelines de datos sin sobrecargar el sistema

🛠 ¿Cómo utilizar la API de Clientes?

Paso 1: Obtén tu Token de Autenticación

1. Ve a Administrador → Usuarios de API

2. Copia tu Token de Acceso

3. Úsalo en el header de cada petición:

Authorization: Bearer TU_TOKEN_AQUI

📸 Token de API disponible en Administrador → Usuarios de API

2. Consulta tu Lista de Contactos

curl -X GET "https://api.adereso.cl/api/external/v2/contacts/" \
  -H "Authorization: Key TU_API_TOKEN"

💡 Tip: La respuesta viene paginada (50 contactos por página por defecto)

3. Filtra por Fecha para Cargas Incrementales

curl -X GET "https://api.adereso.cl/api/external/v2/contacts/?last_message_from=2024-12-01&order_by=last_message_desc" \
  -H "Authorization: Key TU_API_TOKEN"

💡 Esto es ideal para sincronizaciones diarias. Solo traes los contactos que tuvieron actividad desde la última vez.

4. Obtén el Detalle de un Contacto Específico

curl -X GET "https://api.adereso.cl/api/external/v2/contacts/507f1f77bcf86cd799439011/" \
  -H "Authorization: Key TU_API_TOKEN"

🔢 Límites y Restricciones

🔧 Opciones de Ordenamiento

👥 ¿Quién tiene acceso?

🛑 Zona de Peligro: Lee esto antes de usar tu API

🔧 Solución de Problemas

Error 400: "Invalid order_by parameter”

• uname_asc, uname_desc, last_message_asc, last_message_desc

Error 400: "Invalid page parameter”

Error 400: "Invalid date format”

Error 401: Unauthorized

📂 Glosario de Términos

🧪 Pruébalo ahora (Quick Win)

1. Abre tu terminal

2. Reemplaza TU_API_TOKEN con tu token real

3. Ejecuta:

curl -X GET "https://api.adereso.cl/api/external/v2/contacts/?page=1" \
  -H "Authorization: Key TU_API_TOKEN"

1. ¡Deberías ver tus primeros 50 contactos! 🎉

📊 Ejemplo de Respuesta

{
    "status": 200,
    "pagination": {
        "page": 1,
        "pages": 10,
        "total_elements": 150,
        "page_size": 50
    },
    "data": [
        {
            "_id": "507f1f77bcf86cd799439011",
            "name": "Juan Pérez",
            "username": "juanperez",
            "uid": "56912345678",
            "sn": "whatsapp",
            "email": "juan@example.com",
            "phone": ["+56912345678"],
            "last_message": "2024-12-01T14:22:33",
            "updated_at": "2024-12-01T14:22:33",
            "ticket_count": 5
        }
    ]
}

👋🏻 Podría interesarte