Skip to main content
Esta guía lo lleva desde la cuenta hasta el primer envío. Elija su modo a continuación: oficial para producción o no oficial para probar rápidamente.

​
En breve

  • Oficial: inicio de sesión Meta en el panel, tarjeta en WhatsApp Manager, primero envíe con una plantilla aprobada
  • No oficial: crea la instancia, escanea el código en tu teléfono, envía texto libre
  • Ambos usan la misma API; solo cambia la forma de conectar el número.
¿No estás seguro de cuál elegir? Ver Modos de conexión.

​
Antes de empezar

  • Una Clave API (sk_live_... o sk_test_... para sandbox)
  • Permisos de instancia y envío en la clave. Ver Ámbitos
  • En ejemplos, reemplace sk_live_xxxxx con su clave y https://api.notifique.dev con su URL base si es necesario
¿Recién está empezando? Utilice sk_test_... y compruebe los resultados en la bandeja de entrada de Sandbox.

​
1. Conecta el número

Tres caminos, elige el que mejor se adapte a tu integración:

​
1A, a través del panel

  1. WhatsApp → Nueva instancia → Oficial
  2. Inicie sesión con su cuenta Meta y vincule el número
  3. Cuando el estado es activo, anote el ID de instancia

​
1B, vía API con enlace para el cliente

Para incorporación remota (sin navegador en su servidor): cree un borrador y envíe el enlace; el cliente completa el inicio de sesión Meta en la página.Respuesta esperada: 200 con una instancia PENDIENTE y el enlace:Envíe shareableLink.hostedUrl al cliente. Cuando termine, la instancia pasa a activa.
Cualquiera que tenga el enlace puede conectar o desconectar la instancia. Después de su uso, rote el secreto con POST /v1/whatsapp/instances/:instanceId/connect-page/rotate-secret.

​
1C, vía API con credenciales Meta

Con Embedded Signup ya hecho en el navegador, cree una instancia oficial ya activa usando los tres campos Meta:Respuesta esperada: 200 con una instancia activa:
Resumen: panel para la ruta más sencilla; generateShareableLink: true cuando otra persona necesita completar el inicio de sesión Meta; metaEmbeddedCode + metaPhoneNumberId + metaWabaId cuando ya tienes datos de registro integrado.

​
2. Agrega una tarjeta en el Administrador de WhatsApp

Meta factura conversaciones en tu cuenta. Sin una tarjeta registrada, los envíos de producción no funcionarán.
  1. Abra Administrador de WhatsApp
  2. Vaya a Configuración de pago
  3. Añada una tarjeta válida
  4. En el panel de Notifique, confirme que el pago esté activo

​
3. Sincronizar plantillas

En el panel, use Sincronizar plantillas con Meta (o cree una nueva). Necesita una plantilla aprobada para el primer contacto.Detalles: Plantillas oficiales Meta.

​
4. Envía tu primera plantilla

Fuera de un chat reciente, el oficial requiere una plantilla aprobada:Respuesta esperada: 202 con el mensaje en cola:

​
5. Chat después de que respondan

Cuando el cliente responda, tiene unas 24 horas para enviar texto o medios libres:Respuesta esperada: 202:Fuera de esa ventana, use una plantilla nuevamente.

​
Después del primer envío

  • Siga entrega y lectura vía webhooks
  • ¿Varios números? Consulte Sending Pools
  • Campos y rutas completos: Referencia API en la pestaña WhatsApp

​
Próximos pasos