API de WhatsApp para desarrolladores

API de WhatsApp para desarrolladores

Tu sistema manda avisos, códigos y mensajes con botones con una llamada HTTP, y BUZWIK te avisa por webhook cada entrega, lectura y respuesta. Sobre la API oficial de WhatsApp Business, sin manejar tokens ni plantillas de Meta a mano.

Tu propio númeroBásico: la API de envíos, los códigos OTP y los webhooks están en todos los planes. El chatbot para tu web, desde Estándar.
Aviso enviado por API
  • API oficial de WhatsApp BusinessSobre la Cloud API de Meta, sin apps no oficiales.
  • Registro oficial de MetaConectás tu número desde la ventana de Facebook.
  • Plantillas aprobadasLos mensajes que iniciás pasan la revisión de WhatsApp.
  • Servidores en la Unión EuropeaTus datos, alojados y separados por empresa.
Qué resolvés

Lo que tu sistema puede hacer

Endpoints REST con JSON, respuestas con el mismo formato y errores con códigos estables.

Envío directo

POST /api/messages manda una plantilla aprobada por su nombre, con sus variables y el payload de cada botón. Dentro de las 24 h, también texto libre o un mensaje con hasta 3 botones, una lista de 10 opciones o un botón con link.

Sin duplicados al reintentar

Si mandás una reference, el mismo pedido nunca sale dos veces: la respuesta trae duplicate: true y el mensaje original. Esa reference vuelve en los webhooks.

Códigos de verificación

POST /api/otp/send y /api/otp/verify: BUZWIK genera, entrega y valida códigos de un solo uso, con vencimiento e intentos limitados.

Webhooks firmados

Mensajes recibidos, estados de entrega, botones tocados, solicitudes, citas y derivaciones a una persona. Firma HMAC-SHA256, hasta 8 intentos en unas 45 horas, historial de 30 días y reenvío manual.

Eventos y automatizaciones

Con POST /api/events tu sistema solo avisa «pasó esto» y el mensaje se arma en el panel: el texto se cambia sin tocar código.

Contactos y más

Crear o actualizar contactos por teléfono, con etiquetas, campos extra y consentimiento. También solicitudes, catálogo, agenda y puntos de entrada por API.

API keys con permisos

Cada key lleva solo los permisos que necesita, vencimiento opcional y su último uso a la vista. Una key filtrada no puede tocar plantillas, números ni webhooks, y se revoca al instante.

Errores y límites claros

Códigos como CONTACT_OPTED_OUT o CONVERSATION_WINDOW_CLOSED te dicen qué decidir. Hasta 300 envíos por minuto por empresa, y un 429 con Retry-After si te pasás.

Docs pensadas también para tu IA

Referencia completa en Markdown, llms.txt y especificación OpenAPI 3.1, con ejemplos en curl y Node.js y un checklist para que un agente de IA haga la integración sin inventar endpoints.

Puesta en marcha

Cómo se pone en marcha

Te acompañamos en cada paso. En general es cuestión de días, no de semanas.

  1. Conectá tu número y tus plantillas

    Desde el panel: tu WhatsApp, a nombre de tu empresa, y las plantillas que vas a usar, aprobadas por WhatsApp.

  2. Creá una API key

    En Configuración, con los permisos justos. El secreto se muestra una sola vez.

  3. Probá y enviá

    GET /api/ping para verificar la key y después tu primer POST /api/messages a tu propio número.

  4. Recibí los webhooks

    Cargá tu URL, verificá la firma y usá el botón de prueba para recibir un evento de ejemplo.

Preguntas

Preguntas frecuentes

¿Es la API oficial de WhatsApp?
Sí. BUZWIK funciona sobre la Cloud API de WhatsApp Business de Meta, con tu propio número. Tu sistema habla con la API de BUZWIK y BUZWIK se encarga de los tokens, las plantillas y el envío a Meta.
¿Puedo mandarle un mensaje por API a alguien que no me escribió?
Solo con una plantilla aprobada por WhatsApp. El texto libre y los mensajes con botones propios se pueden mandar dentro de las 24 horas desde el último mensaje del contacto; fuera de ese plazo la API responde CONVERSATION_WINDOW_CLOSED.
¿Cómo evito mandar un mensaje dos veces si mi sistema reintenta?
Mandá siempre una reference propia (por ejemplo, turno-48213-recordatorio). Si el mismo pedido llega de nuevo, BUZWIK devuelve el mensaje original y no envía otro.
¿Cuánto cuesta cada mensaje enviado por la API?
Lo cobra Meta directo a tu tarjeta, según el país del destinatario: un aviso a Uruguay sale alrededor de US$0,011 y una promoción, unos US$0,074. En BUZWIK cada mensaje enviado cuenta para el límite de tu plan; pasarte no corta nada y se cobra a US$5 cada 1.000.
¿Qué límites de envío tiene?
300 envíos por minuto por empresa en /api/messages y 60 por minuto en los códigos. Además, WhatsApp limita a cuántas personas distintas le escribe cada número por día y lo va subiendo con el uso.
¿Se pueden programar envíos o mandar archivos por la API?
Hoy no: /api/messages envía en el momento (los recordatorios los agenda tu sistema) y no manda archivos. Las campañas sí se programan desde el panel.

Conectá tu WhatsApp y empezá a enviar.

Te acompañamos en la puesta en marcha. Mirá los planes o escribinos y lo vemos juntos.