Resumen
Cree un registro de contacto único. Los tres campos del cuerpo son obligatorios. Los números deben incluir el código de país sin signo más en muchas integraciones — valide según sus reglas locales. Tras la creación, use el id de contacto en envíos WhatsApp mediante contact_id.
POST /api/contacts/
Llame a este endpoint con POST y un token bearer válido.
curl -X POST 'https://app.buzzbip.com/api/contacts/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"firstname": "Jane", "lastname": "Doe", "number": "21690123456"}'Notas de uso
Crea un contacto. Los tres campos del body son obligatorios. Los números deben incluir código de país. Tras crear, usa contact_id en envíos WhatsApp.
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/list-contacts api/whatsapp-messaging/send-whatsapp-message guides/sync-contacts-from-crm