Saltar al contenido principal

Obtener un número de WhatsApp en Meta

Prepara un número de tu negocio en Meta para conectarlo a tu agente de IA para WhatsApp.

Antes de que un agente de IA para WhatsApp pueda hablar con tus clientes, Meta necesita saber qué número de teléfono va a usar. Esta guía explica cómo preparar ese número en la plataforma WhatsApp Business de Meta y qué datos debes traer de vuelta a Ordering.co.

Dos formas de conectar

En el AI Dashboard puedes conectar WhatsApp con WhatsApp Business Login o con Manual Credentials. Con WhatsApp Business Login, Meta te guía para agregar y verificar el número dentro de la ventana de inicio de sesión, así que solo necesitas lo que aparece en Antes de empezar. Usa la configuración completa en Meta solo si vas a usar Manual Credentials.

Las pantallas de Meta pueden aparecer en español o en inglés según tu idioma. En esta guía los nombres de las opciones de Meta se muestran en inglés.

Antes de empezar​

Ten listo lo siguiente:

  • Una cuenta de Facebook que administrará el negocio en Meta.
  • Un portafolio comercial de Meta (antes Business Manager). Puedes crearlo durante la configuración si aún no tienes uno.
  • Un número de teléfono para WhatsApp. Debe:
    • pertenecer a tu negocio;
    • incluir el código de país y de área;
    • poder recibir un SMS o una llamada, para que Meta envíe un código de verificación;
    • ser un número normal, no un código corto.
  • Un nombre visible, que es el nombre del negocio que ven tus clientes en WhatsApp. Usa el nombre real de tu negocio o marca.
  • Documentos del negocio para la verificación de Meta, como tu registro comercial y un comprobante de domicilio.
El número no puede estar en uso en WhatsApp

Si el número está activo en la app de WhatsApp o WhatsApp Business, debes eliminarlo de esa app antes de que Meta lo registre. Una vez registrado en la plataforma, ya no podrá usarse en esas apps. Si quieres conservar tu número actual en la app, usa un número diferente para tu agente de IA.

Opción A: Conectar con WhatsApp Business Login (recomendado)​

  1. En el AI Dashboard, abre AI Agents y selecciona Create Agent.
  2. Elige WhatsApp como canal y selecciona la marca.
  3. Elige WhatsApp Business Login.
  4. En la ventana de Meta, inicia sesión con tu cuenta de Facebook y sigue los pasos:
    • selecciona o crea tu portafolio comercial;
    • selecciona o crea una cuenta de WhatsApp Business;
    • agrega tu número de teléfono y el nombre visible;
    • escribe el código de verificación que Meta envía por SMS o llamada.
  5. Cuando se cierre la ventana de Meta, termina la configuración del agente. Consulta Crear un agente de IA para WhatsApp.

Opción B: Configurar el número tú mismo en Meta​

Sigue este camino para obtener los datos de Manual Credentials.

1. Crear una app de Meta con el caso de uso de WhatsApp​

  1. Entra a developers.facebook.com/apps y selecciona Create App.
  2. Escribe un nombre para la app y tu correo de contacto.
  3. Selecciona el caso de uso Connect with customers through WhatsApp.
  4. Selecciona tu portafolio comercial o crea uno.
  5. Revisa los datos y selecciona Create app.

Meta abre Customize use case → Connect on WhatsApp. En Choose your integration type, deja seleccionada la opción Integrate with API.

2. Probar con el número de prueba de Meta (opcional)​

Step 1. Try it out te da un número de prueba gratuito para enviar un mensaje de ejemplo. Puedes saltarte este paso. El número de prueba no es el número al que escribirán tus clientes.

3. Agregar el número de tu negocio​

Sigue Step 2. Production setup:

  1. Selecciona o crea la cuenta de WhatsApp Business de tu negocio.
  2. Selecciona Add phone number.
  3. Escribe el nombre visible y los datos del negocio.
  4. Escribe tu número en formato internacional, por ejemplo +52 33 1234 5678.
  5. Elige Text message o Phone call y escribe el código de verificación.

También puedes agregar números después en WhatsApp Manager → Account tools → Phone numbers.

consejo

Meta permite que las cuentas nuevas registren dos números al principio. El límite puede aumentar después de la verificación del negocio y de la aprobación del nombre visible.

4. Verificar tu negocio​

Sigue Step 3. Business verification y sube los documentos que Meta te pida. Meta los revisa y aprueba tu nombre visible. Mientras tanto, tu número puede tener límites en la cantidad de clientes a los que puede escribir.

5. Agregar un método de pago​

En WhatsApp Manager, abre la configuración de pagos y agrega un método de pago. Meta cobra algunos mensajes iniciados por el negocio; revisa los precios actuales de Meta para tu país.

6. Crear un token de acceso permanente​

El token que aparece durante la prueba vence rápido. Tu agente necesita uno de larga duración:

  1. Abre la configuración del negocio en business.facebook.com/settings y selecciona System users.
  2. Selecciona Add, ponle nombre al usuario del sistema y dale el rol Admin.
  3. Selecciona el usuario del sistema y luego Assign assets:
    • tu app, con Manage app (control total);
    • tu cuenta de WhatsApp, con Manage WhatsApp Business accounts (control total).
  4. Selecciona Generate token, elige tu app y agrega estos permisos:
    • business_management
    • whatsapp_business_messaging
    • whatsapp_business_management
  5. Copia el token y guárdalo en un lugar seguro. Meta lo muestra una sola vez.
Mantén el token en privado

Cualquier persona con este token puede enviar mensajes en nombre de tu negocio. No lo pegues en correos, chats ni tickets de soporte.

7. Copiar los datos que necesitas​

En tu app de Meta, abre WhatsApp → API Setup y copia:

  • el Phone number ID, el identificador del número que agregaste;
  • el WhatsApp Business Account ID;
  • el número de teléfono.

8. Ingresar los datos en Ordering.co​

  1. En el AI Dashboard, abre AI Agents y selecciona Create Agent.
  2. Elige WhatsApp, selecciona la marca y elige Manual Credentials.
  3. Escribe el Channel External ID (el Phone number ID), el Phone Number y el Access Token.
  4. Guarda y prueba el agente con el código QR. Consulta Crear un agente de IA para WhatsApp.

Comprobar el resultado​

En WhatsApp Manager → Phone numbers, tu número aparece como Connected. En el AI Dashboard, el agente aparece activo y, al escanear el código QR, un mensaje de prueba recibe respuesta.

Solución de problemas​

Meta no envía el código de verificación​

Confirma que el número pueda recibir SMS o llamadas de remitentes internacionales y prueba el otro método (mensaje o llamada). Los números gratuitos con menú telefónico deben poder transferir la llamada de Meta a una persona.

Meta dice que el número ya está registrado​

El número sigue activo en la app de WhatsApp o WhatsApp Business, o está registrado con otro proveedor. Elimina la cuenta de WhatsApp en ese teléfono, o pide al otro proveedor que libere el número, y vuelve a intentarlo. Si ese número tiene activada la verificación en dos pasos, primero debes desactivarla.

El agente dejó de responder​

Si usaste Manual Credentials, el token de acceso pudo haber vencido o haber sido revocado. Genera un nuevo token del usuario del sistema y actualiza el agente. Confirma también que el número siga apareciendo como Connected en WhatsApp Manager.

Meta rechazó mi nombre visible​

Edita el nombre visible en WhatsApp Manager para que coincida con el nombre de tu negocio y vuelve a enviarlo.

Guías relacionadas: Crear un agente de IA para WhatsApp · Analizar conversaciones