Cómo conectar WhatsApp API a tu ISP

Qué haces tú y qué hacemos nosotros

W-Chat es proveedor tecnológico de Meta (Tech Provider). Por eso no tienes que crear apps, generar tokens ni configurar webhooks: basta con que tu ISP tenga su cuenta de WhatsApp en regla y nos la comparta como socio.

Requisitos previos

• Un número de teléfono propio que pueda recibir un SMS o una llamada una sola vez, y que no esté activo en ninguna app de WhatsApp.
• Una cuenta personal de Facebook para entrar a Meta Business. No se publica nada con ella: solo es la llave de acceso.
• Documentos del ISP para la verificación: RUC o registro mercantil y un comprobante con la dirección (planilla de servicios, estado de cuenta bancario o licencia de funcionamiento), con el nombre legal idéntico en los dos.
• Un sitio web y un correo con el dominio del ISP. Meta los usa para corroborar que el negocio existe; con un correo de Gmail la verificación se complica.
• Una tarjeta de crédito o débito internacional para el método de pago de la cuenta de WhatsApp.
• El ID de socio de W-Chat. Te lo enviamos nosotros; pídelo por WhatsApp o correo antes del paso 5.

Paso a paso

1. Crear el portafolio comercial

   business.facebook.com

   El portafolio comercial (antes “Business Manager”) es tu empresa dentro de Meta: de él cuelgan la cuenta de WhatsApp, el número y los socios con los que la compartes.

   1. Entra a business.facebook.com y pulsa Crear cuenta.
   2. Pon el nombre legal del ISP, tal como aparece en el RUC, no el nombre comercial. Es el que Meta va a contrastar con los documentos.
   3. Completa dirección, sitio web y teléfono de la empresa.
   4. Confirma el correo de empresa que te llega.

   Si tu ISP ya tiene un portafolio con páginas de Facebook o Instagram, úsalo; no crees uno nuevo.

2. Verificar el negocio

   Configuración del negocio › Centro de seguridad

   Sin verificación, Meta limita el número a 250 conversaciones iniciadas por el negocio cada 24 horas, no aprueba el nombre visible y deja fuera las llamadas. Es el paso que más tarda, así que se arranca cuanto antes: el resto avanza en paralelo.

   1. Abre el Centro de seguridad y pulsa Comenzar verificación.
   2. Sube los documentos. Que el nombre legal, la dirección y el teléfono coincidan carácter por carácter con lo que pusiste en el portafolio: la mayoría de los rechazos son por una abreviatura distinta (“Cía. Ltda.” frente a “Compañía Limitada”).
   3. Verifica el teléfono o el dominio cuando lo pida.
   4. Espera la resolución: de unas horas a unos días hábiles.
   Se puede seguir mientras tanto

   Con el negocio sin verificar el número ya envía y recibe: solo está topado. Continúa con los pasos siguientes. La verificación abre el camino a las 2.000 conversaciones diarias, pero Meta no da plazo para ese salto: el límite real se ve en WhatsApp Manager › Números de teléfono.

3. Crear la cuenta de WhatsApp y dar de alta el número

   business.facebook.com › WhatsApp Manager

   La cuenta de WhatsApp Business (WABA) agrupa tus números de WhatsApp. Créala dentro del mismo portafolio del paso 1.

   1. Abre WhatsApp Manager desde el menú de Meta Business y crea la cuenta de WhatsApp si todavía no tienes una.
   2. En Números de teléfono, pulsa Agregar número de teléfono.
   3. Nombre visible: el que verán tus clientes en el chat. Tiene que guardar relación con el negocio — Meta rechaza nombres genéricos como “Soporte” o “Ventas”.
   4. Elige categoría y escribe una descripción corta del negocio.
   5. Escribe el número con código de país y verifícalo por SMS o llamada.
   6. Si te pide un PIN de seis dígitos (verificación en dos pasos), invéntalo y anótalo. Es del número, no de W-Chat, y hace falta si algún día hay que volver a registrarlo o moverlo de proveedor.
   El nombre visible se revisa aparte

   Su aprobación va ligada a la verificación del negocio y al volumen del número. Hasta que se apruebe, los clientes ven el número en vez del nombre. No bloquea nada: W-Chat funciona igual.

4. Añadir el método de pago

   Configuración del negocio › Cuentas › Cuentas de WhatsApp

   1. Abre tu cuenta de WhatsApp y entra a Método de pago (también aparece en WhatsApp Manager).
   2. Añade una tarjeta de crédito o débito internacional a nombre del ISP.

   Sin método de pago, las plantillas y los mensajes que inicia el negocio dejan de salir en cuanto se agota el cupo gratuito. Las conversaciones que abre el cliente —las respuestas dentro de la ventana de 24 horas— no se cobran, así que el gasto real de un ISP suele ser bajo; pero la tarjeta tiene que estar cargada. Meta te cobra directamente a ti: W-Chat no intermedia ese pago.

5. Añadir a W-Chat como socio

   Configuración del negocio › Usuarios › Socios

   Así le das a W-Chat acceso a tu cuenta de WhatsApp sin compartir contraseñas: el acceso queda registrado en tu portafolio y lo puedes retirar cuando quieras.

   1. En Configuración del negocio, abre Usuarios › Socios y pulsa Agregar.
   2. Elige Dar a un socio acceso a tus activos.
   3. Escribe el ID de socio de W-Chat —el número que te enviamos— y confirma.
   El ID de socio te lo damos nosotros

   Pídenoslo por WhatsApp o correo antes de llegar a este paso. Comprueba que el nombre que muestra Meta al pegar el ID sea W-Chat antes de confirmar.

6. Compartir la cuenta de WhatsApp con W-Chat

   Configuración del negocio › Cuentas › Cuentas de WhatsApp

   1. Selecciona la cuenta de WhatsApp del paso 3.
   2. Pulsa Asignar socios (o Socios › Agregar) y elige a W-Chat.
   3. Dale control total sobre la cuenta y guarda.

   Con eso termina tu parte. Ya no hace falta entrar a Meta for Developers, crear una app, generar tokens ni configurar el webhook: todo eso lo resolvemos nosotros con nuestra app de Meta.

7. Avisarnos y probar el número

   WhatsApp o [email protected]

   Escríbenos cuando hayas compartido la cuenta. Nosotros generamos el acceso, conectamos el webhook y damos de alta el número en tu W-Chat.

   Cuando te confirmemos, manda un WhatsApp desde tu celular personal al número del ISP: debe aparecer en la bandeja de Mensajes en pocos segundos. Responde desde W-Chat y comprueba que te llega. Con eso el circuito está cerrado en los dos sentidos.

8. Habilitar las llamadas opcional

   Lo activamos nosotros cuando Meta lo permita

   Las llamadas de voz por WhatsApp vienen apagadas de fábrica y no se encienden el primer día. Meta exige antes:

   • el negocio verificado (paso 2);
   • el número con un límite de mensajería de 2.000 destinatarios al día o más, que se alcanza usando el número con normalidad: Meta revisa calidad y volumen y va subiendo el escalón.

   Cumplido eso, pídenos activarlas y las encendemos desde nuestro lado. Sobre cómo se comportan después: para llamar a un cliente hace falta su permiso, y W-Chat lo pide solo con un botón dentro del chat. El permiso caduca, el cliente puede revocarlo y Meta lo retira tras cuatro llamadas seguidas sin contestar. Las llamadas que entran desde el cliente no necesitan permiso de nada.

   Con un número en coexistencia este paso no aplica: las llamadas se siguen recibiendo en la app del teléfono, no en W-Chat.

9. Dar de alta las plantillas

   W-Chat › Campañas

   Para escribirle primero a un cliente pasadas 24 horas desde su último mensaje, WhatsApp obliga a usar una plantilla aprobada: avisos de corte, recordatorios de pago, confirmación de visita técnica. W-Chat las envía a revisión de Meta desde el propio sistema y muestra el estado.

   La aprobación suele tardar minutos, a veces horas. Se rechazan por prometer cosas que no se cumplen, por parecer publicidad no pedida o por errores de redacción. Las respuestas dentro de la ventana de 24 horas no usan plantilla: se escriben libres.

Comprobación final

• El portafolio está a nombre legal del ISP y la verificación del negocio está aprobada o en revisión.
• El número aparece en WhatsApp Manager › Números de teléfono con su nombre visible enviado a revisión.
• La cuenta de WhatsApp tiene método de pago cargado.
• W-Chat aparece en Usuarios › Socios y tiene control total sobre la cuenta de WhatsApp.
• Te confirmamos la conexión y en W-Chat, Ajustes › WhatsApp muestra el número como conectado.
• Un mensaje de prueba entra a la bandeja y la respuesta llega al celular.

Cuando algo falla