Saltar a contenido

Vincular una cuenta Meta Official

Objetivo: conectar un número de WhatsApp Business oficial a Arplyx usando tu propia app de Meta. A diferencia de WhatsApp Direct (que se vincula con un QR), acá el circuito pasa por la plataforma de Meta: creás una app, obtenés tres credenciales y las pegás en el portal. La cuenta queda conectada al instante.

Actores

Note

El tope de cuentas vinculadas (Direct + Meta combinadas) depende de tu plan: 1 (Free y Starter), 3 (Basic) o 5 (Pro).

Qué vas a necesitar al final

Tres valores que vas a copiar desde Meta y pegar en Arplyx:

Credencial Dónde se obtiene
Phone number ID Panel de WhatsApp de tu app, sección API Setup
WABA ID (WhatsApp Business Account ID) Mismo panel, debajo del Phone number ID
Token de acceso permanente System user en Business Settings

Paso 1 — Prepará tu cuenta de Meta Business

  1. Entrá a business.facebook.com y creá (o usá) un portafolio comercial (Meta Business Portfolio).
  2. En Configuración del negocio → Centro de seguridad, iniciá la verificación del negocio si aún no está hecha.

Warning

La verificación del negocio puede tardar de horas a varios días y requiere documentación (razón social, dominio, teléfono). Sin verificación, Meta limita la cantidad de conversaciones diarias y algunas funciones. Empezá este trámite primero.

Paso 2 — Creá la app en Meta for Developers

  1. Andá a developers.facebook.com/apps y clic en Crear app.
  2. Elegí el tipo Negocios (Business) y asociala a tu portafolio comercial.
  3. En el panel de la app, buscá el producto WhatsApp y tocá Configurar.

Paso 3 — Registrá tu número y copiá los IDs

  1. En el panel de WhatsApp de tu app, andá a API Setup (Configuración de la API).
  2. Agregá tu número de teléfono comercial y verificalo por SMS o llamada. El número no puede estar registrado en otra cuenta de WhatsApp (ni personal ni Business App); si lo está, primero eliminá esa cuenta desde el teléfono.
  3. Copiá el Phone number ID (no es el número de teléfono, es un ID numérico largo).
  4. Copiá el WhatsApp Business Account ID (WABA ID), que aparece en el mismo panel.

Note

El token temporal que muestra esta pantalla sirve solo 24 horas. No lo uses para Arplyx: en el paso siguiente generamos uno permanente.

Paso 4 — Generá un token de acceso permanente

  1. En Business Settings → Usuarios → System users, creá un system user (rol Admin o Employee).
  2. Tocá Agregar activos y asignale tu app con permiso de administración.
  3. Clic en Generar token, elegí tu app y marcá los permisos:
  4. whatsapp_business_messaging
  5. whatsapp_business_management
  6. En expiración elegí Nunca y generá el token. Copialo en el momento.

Warning

El token se muestra una sola vez y da control sobre tu cuenta de WhatsApp Business. Guardalo en un gestor de contraseñas y no lo compartas. En Arplyx se almacena cifrado; si lo regenerás en Meta, vas a tener que eliminar y volver a vincular la cuenta.

Paso 5 — Vinculá la cuenta en Arplyx

  1. En el portal, andá a Cuentas → Agregar cuenta.
  2. Elegí Meta Official.
  3. Pegá las tres credenciales: Phone number ID, WABA ID y token de acceso. Si querés, agregá un nombre descriptivo.
  4. Clic en Vincular. Arplyx valida las credenciales contra la API de Meta en el momento:
  5. Si son válidas, la cuenta queda Conectada al instante, con el número y el nombre verificado que figura en Meta.
  6. Si Meta las rechaza, el portal te indica cuál es el problema (token inválido, Phone number ID inexistente o WABA que no corresponde al token).

Paso 6 — Configurá el webhook (estados y recepción)

Para que Arplyx reciba los estados de entrega (enviado, entregado, leído) y los mensajes entrantes, tu app de Meta tiene que apuntar su webhook al gateway de Arplyx. La pantalla de éxito del portal te muestra los dos valores; también quedan en el detalle de la cuenta.

  1. En el panel de tu app: WhatsApp → Configuration → Webhook, clic en Edit.
  2. Pegá:
  3. Callback URL: https://api.arplyx.com/webhooks/whatsapp
  4. Verify token: el que muestra el portal en la pantalla de vinculación.
  5. Clic en Verify and save.
  6. En Webhook fields, suscribite al campo messages.

Note

Sin este paso los mensajes igual salen, pero no vas a ver los estados delivered/read ni vas a recibir mensajes entrantes en el Inbox.

Paso 7 — Probá el envío

  1. En la tarjeta de la cuenta, clic en Mensaje de prueba.
  2. Usá un número que haya escrito a tu número comercial en las últimas 24 horas (por ejemplo, mandate un WhatsApp desde tu teléfono al número comercial primero).
  3. Verificá que llegue y que aparezca en Mensajes con canal Meta Official.

La ventana de 24 horas

La API oficial de Meta solo permite enviar texto libre a personas que te escribieron en las últimas 24 horas (ventana de servicio). Para iniciar conversaciones fuera de esa ventana, Meta exige plantillas aprobadas (HSM), que creás en tu WhatsApp Manager y enviás desde Arplyx (ver Enviar mensajes → plantillas). El envío de plantillas está disponible desde el plan Starter; en Free, Meta funciona solo para responder dentro de la ventana.

Cómo elegir la cuenta al enviar por API

Si tenés una sola cuenta Meta conectada, los mensajes con "channel": "whatsapp_meta" salen por ella automáticamente. Si tenés más de una, agregá el campo whatsappAccountId en el POST /messages para indicar cuál usar; el ID figura en la tarjeta de la cuenta.

Listo: la cuenta queda disponible para el envío por API y la recepción en Inbox.