Este es el único artículo de esta serie escrito para quien tiene un programador cerca. Si ese no es tu caso, salta al siguiente: no te estás perdiendo nada del día a día.
1 Para quién es esto
Hay tres situaciones donde esto vale oro:
- Tienes un sistema propio —hecho a medida hace años— y quieres que avise por WhatsApp cuando un pedido sale de almacén.
- Tienes un e-commerce y quieres confirmar el pedido por WhatsApp en vez de por correo, que nadie abre.
- Eres una software factory y tu cliente te pide “WhatsApp” sin saber que eso implica montar toda una infraestructura con Meta.
En los tres casos, la alternativa es levantar tú la integración con la plataforma de Meta: números, verificaciones, plantillas, webhooks, colas de reintento. Semanas de trabajo antes del primer mensaje.
Todo lo que afirma esta guía está comprobado sobre el sistema real. Las capturas son pantallas reales de Facturalaya, no maquetas.
2 Claves de servicio
La API se abre con una clave que generas desde la propia pantalla:
Tres cosas de esa pantalla:
La clave se muestra una sola vez. Al generarla ves el valor completo; después, solo el prefijo. No es una molestia, es cómo debe funcionar: si el sistema pudiera mostrártela otra vez, también podría mostrársela a alguien más. Cópiala a un gestor de secretos o a una variable de entorno en ese momento.
Viaja como Bearer. La autenticación es una cabecera Authorization: Bearer fy_live_…, el
estándar que cualquier programador implementa en cinco minutos.
Cada clave hereda permisos. No es una llave maestra: está atada a una cuenta de servicio con su propio alcance, igual que un usuario del equipo (cómo funcionan los roles y permisos).
Genera tu primera clave y manda un mensaje de prueba desde tu propio sistema.
Quiero probarlo gratis3 Una clave por integración
Puedes tener hasta 20 claves activas, y conviene usarlas: una para el e-commerce, otra para el ERP, otra para el ambiente de pruebas del programador.
¿Por qué? Por la columna último uso y por el botón de revocar. Si mañana hay que cortar el acceso de una integración —cambió el proveedor, se filtró una clave, se apagó un proyecto— revocas esa y las demás siguen funcionando. Con una sola clave compartida, cortar significa apagar todo.
4 Reintentos que no duplican
El detalle que separa una API de juguete de una que se puede poner en producción.
Todo sistema reintenta: se cae la red, el servidor no responde a tiempo, la cola vuelve a mandar el mismo pedido. Si la API no maneja eso, el cliente recibe el mismo mensaje tres veces y tu número paga el costo.
Esta API maneja idempotencia: un reintento con el mismo identificador no genera un segundo envío. Y los errores vienen tipados, así que tu sistema puede distinguir “esa plantilla no existe” de “la ventana de 24 horas está cerrada” y actuar distinto en cada caso, en vez de reintentar a ciegas.
5 Casos que se resuelven bien
- Avisos operativos: pedido confirmado, pedido despachado, cita para mañana. Con plantilla aprobada de utilidad.
- Cobranza: recordatorio de vencimiento disparado por tu sistema contable.
- Postventa: encuesta simple después de una entrega.
- Alertas internas: que tu sistema avise al equipo por WhatsApp cuando algo se rompe.
En todos, la lógica de negocio se queda en tu sistema —que es donde debe estar— y WhatsApp es solo el canal de salida.
6 Los límites
- Las reglas de WhatsApp siguen valiendo. Fuera de la ventana de 24 horas, tu sistema tiene que usar una plantilla aprobada. La API no te salta esa regla: la aplica (qué es la ventana de 24 horas).
- La clave no se recupera. Si la perdiste, se revoca y se genera otra.
- Hay límites de uso. Están para proteger tu número, no para molestarte.
- Esto no es “WhatsApp gratis para todos”. Los mensajes que inicia tu sistema fuera de la ventana los cobra Meta, igual que en una campaña.
- El módulo no está disponible para todos los clientes de Facturalaya. Si compraste el sistema a través de un socio, consulta con él antes de planear una integración.
Y si lo que vas a automatizar son avisos comerciales, revisa antes a quién puedes escribirle: Ley 29733 y WhatsApp.
Preguntas frecuentes
¿Para qué sirve esta API?
¿Cómo se autentica?
Authorization: Bearer. Cada clave hereda los permisos de una cuenta de servicio interna.¿Puedo ver mi clave después de crearla?
¿Cuántas claves puedo tener?
¿Qué pasa si mi sistema reintenta un envío?
Pruébalo hoy con tus propios productos
Crea tu cuenta gratis y compruébalo en tu negocio. Sin tarjeta de crédito, sin contratos.
Sigue aprendiendo
WhatsApp con IA para distribuidoras: pedidos que llegan en audio y clientes que se enfrían
Una distribuidora vive de dos cosas: que el pedido no se pierda y que el cliente no deje d…
Las llamadas telefónicas también son parte del CRM
El cliente pidió que lo llamaras, hablaron veinte minutos, acordaron un precio. Al día sig…
Qué puede tocar cada persona de tu equipo en el WhatsApp del negocio
El día que entra el primer vendedor nuevo aparece la pregunta incómoda: ¿le doy acceso al …