Resumen
Recupere una lista paginada de contactos. Use el parámetro number para buscar un teléfono específico. Los resultados están limitados al usuario autenticado. Combine con trabajos de sincronización CRM para conciliar IDs externos con los id de contacto Buzzbip usados en envíos WhatsApp.
GET /api/contacts/
Llame a este endpoint con GET y un token bearer válido.
curl -X GET 'https://app.buzzbip.com/api/contacts/?currentPage=1&limit=20&number=' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json'Notas de uso
Obtén lista paginada de contactos. Usa el parámetro number para buscar un número. Respeta la paginación documentada.
Use paginación y filtros para reducir el tamaño de la respuesta.
Notas de integración
Al integrar este endpoint de Buzzbip, use https://app.buzzbip.com como host de producción. Obtenga JWT de POST /api/login_check y envíe Authorization: Bearer en cada solicitud. Confirme que User.hasApiAccess está habilitado en el admin de Buzzbip. Analice respuestas JSend (status, message, data). Para plugins e-commerce, envíe también x-api-key, x-platform-type y x-base-uri. Respete las barras finales en POST /api/contacts/ y POST /api/whatsapp/. Implemente reintentos con backoff ante límites de tasa. Guarde credenciales en el servidor y reautentíquese antes del vencimiento JWT (3600 s).
Seguridad
Buenas prácticas: credenciales solo en servidor, TLS obligatorio, monitorear fallos de autenticación. Separe cuentas staging y producción. Documente plantillas y automatizaciones. Redacte números y contenido en registros compartidos.
¿Qué sigue?
Páginas relacionadas: api/contacts/create-contact api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm