Saltar al contenido principal

Meta Cloud API (WhatsApp Business)

WhatsUY se integra con la API oficial de WhatsApp Business hosteada por Meta (Graph API v25.0).

Onboarding​

  1. Crear app en Meta for Developers.
  2. Configurar producto WhatsApp.
  3. Vincular WABA (WhatsApp Business Account).
  4. Obtener access token y phone number ID.
  5. Configurar la referencia en WhatsUY con type: "meta-cloud".

Templates (plantillas)​

Las plantillas de mensaje deben ser aprobadas por Meta. Se gestionan vía:

POST /templates
{ "reference": 12345, "name": "bienvenida", "category": "MARKETING", "language": "es", "components": [...] }

GET /templates?reference=12345

Estados posibles: PENDING | APPROVED | REJECTED | DISABLED.

Envío con template​

POST /chats/send
{
  "reference": 12345,
  "chatId": "59891234567",
  "message": {
    "type": "template",
    "template": { "name": "bienvenida", "language": { "code": "es" }, "components": [...] }
  }
}

Callback entrante​

Meta envía los mensajes entrantes a un webhook público que WhatsUY expone en:

POST /webhooks/meta

Configuralo desde el panel de Meta apuntando a:

https://<tu-host>/webhooks/meta

Verificá con el VERIFY_TOKEN configurado en tu referencia.

Detalle completo: api-documentation/07-meta-cloud-api.mdx.