Centro de ayuda

Manual WISPX

Guías claras para configurar su ISP: portal de clientes, dominio propio, MikroTik y más.

Integraciones

WhatsApp Meta Cloud API: agregar su número

Cómo obtener Phone Number ID, WABA ID y Access Token en Meta for Developers, pegarlos en Wispx y configurar el webhook HTTPS público.

Desde el panel

Tras iniciar sesión: WhatsApp → elija proveedor Meta → complete el formulario de la derecha.

WhatsApp de Wispx vs Meta

WhatsApp de Wispx vincula un celular con QR. Ideal para empezar rápido.

Meta Cloud API es la API oficial de Meta: número Business, plantillas aprobadas y cobro por conversación según tarifas de Meta.

Webhook: solo HTTPS público

Meta solo acepta una Callback URL HTTPS accesible desde Internet. Use exactamente la URL que muestra Wispx en el panel Meta, por ejemplo:
https://wispx.net/api/webhooks/whatsapp

Requisitos

  • Cuenta Meta Business / WhatsApp Business Account (WABA).
  • App en Meta for Developers con producto WhatsApp.
  • Número de WhatsApp Business (prueba o producción) agregado a la app.
  • Access Token con permisos de WhatsApp (temporal o System User permanente).

1. Datos en Meta for Developers

1

Abrir la app

Entre a developers.facebook.com, seleccione su app y el producto WhatsApp → API Setup (o Configuration).
2

Copiar identificadores

Anote:
  • Phone number ID — ID del número (no es el +593…).
  • WhatsApp Business Account ID (WABA ID).
  • Temporary access token o un token permanente de System User.
3

App Secret (recomendado)

En Configuración de la app → Básica → App Secret. Sirve para validar firmas del webhook.

2. Pegar datos en Wispx

1

Elegir proveedor Meta

En WhatsApp, active la tarjeta Meta.
2

Completar el formulario

En el panel derecho Meta Cloud API complete Phone Number ID, WABA ID, Access Token, App Secret (opcional) y Verify Token (una cadena secreta que invente usted, por ejemplo teledatos-verify-2026).
3

Guardar

Pulse Guardar Meta y proveedor. El token no se muestra completo después de guardado.

3. Configurar el webhook en Meta

1

Callback URL

En Meta → WhatsApp → Configuration, use la URL que muestra Wispx bajo Webhook en Wispx (Meta):
https://wispx.net/api/webhooks/whatsapp
Debe empezar por https://.
2

Verify token

En Meta pegue el mismo Verify Token que guardó en Wispx. Meta enviará una petición GET de verificación; si coinciden, la suscripción queda activa.
3

Suscribir campos

Suscriba al menos messages (y, si aplica, message_template_status_update).

4. Probar

Desde Meta puede enviar un mensaje de prueba al número agregado. En Wispx revise el chat / cola de mensajes entrantes según su plan.

Si Meta rechaza la URL

Compruebe que la URL sea exactamente la HTTPS pública de Wispx, que el Verify Token coincida y que el firewall/Cloudflare no bloquee las IPs de Meta.

Preguntas frecuentes

¿El Phone Number ID es mi número +593…?

No. Es un ID numérico largo que Meta muestra junto al número en API Setup.

¿Sigo usando el QR de Wispx?

Si el proveedor activo es Meta, el canal oficial es Cloud API. Si prefiere celular con QR, elija WhatsApp de Wispx.