WhatsApp Cloud API desde cero

Qué vas a construir

Al final tendrás un agente que conversa por WhatsApp con tus clientes usando la API oficial de Meta (WhatsApp Cloud API), con un portafolio y una app propios, un servidor propio y un panel donde ves y gobiernas todo lo que el agente hace.

Es para quien tiene un negocio, aunque todavía no tenga empresa constituida, y quiere montar un agente de ventas o atención sin depender de un intermediario. Los menús de Meta cambian seguido: guíate por el sentido de cada paso, no por la posición exacta de los botones.

Antes de empezar

Necesitas cuatro cosas:

• Una cuenta personal de Facebook con verificación en dos pasos.
• Un número nuevo (SIM o eSIM) que nunca haya tenido WhatsApp y pueda recibir SMS o llamada.
• Un sitio web con política de privacidad, requisito para publicar la app.
• Un método de pago para los mensajes que Meta cobre.

Para empezar no necesitas una empresa constituida, la verificación del negocio ni la revisión de la app, siempre que uses tu propio número y tu propio portafolio. Sin verificación el límite de envío es más bajo (alrededor de 250 contactos únicos por día al momento de escribir esto; confírmalo en tu panel).

Crear el portafolio comercial

El portafolio comercial de Meta (antes Business Manager) es el contenedor que posee la app, la cuenta de WhatsApp y los permisos. Crea uno por cada operación, para que un bloqueo en una no afecte a la otra.

1. Entra a business.facebook.com y crea el portafolio con el nombre de tu marca.
2. Agrega un segundo administrador y activa la verificación en dos pasos en tu cuenta, para no perder el acceso si algo le pasa a tu perfil.
3. Revisa que Apps, Cuentas de WhatsApp y Cuentas publicitarias estén vacías. Si el portafolio ya existía, identifica qué hay antes de seguir.

Completar los datos del negocio

En Configuración → Información del negocio, pulsa Editar. Meta exige un nombre legal para poder guardar.

• Nombre legal: si aún no tienes empresa, usa tu nombre completo como persona natural, tal como aparece en tu cédula. No inventes una razón social. Cuando constituyas la sociedad, lo cambias antes de pedir la verificación.
• Sitio web: el de tu marca. Ayuda a que aprueben el nombre para mostrar de WhatsApp.
• Teléfono: uno de contacto, distinto al número que registrarás en la API.
• Identificación fiscal: déjala vacía hasta tener NIT o RUT.

Crear la app y elegir un único caso de uso

1. Entra a developers.facebook.com → Mis apps → Crear app.
2. Nombre: hasta 30 caracteres y sin las palabras «WhatsApp» ni «Facebook». Es interno y se puede cambiar después; el nombre que ve el cliente es el del número de WhatsApp.
3. Correo de contacto: uno que revises seguido. Meta lo usa para avisos y para recuperar la app.
4. Caso de uso: elige solo «Conectarte con los clientes a través de WhatsApp». Cada caso adicional suma permisos que Meta puede pedirte justificar.
5. Negocio: selecciona el portafolio del paso 1. Es lo que une la app con él.
6. Requisitos y resumen: con número y portafolio propios no apareció ningún requisito. Revisa y pulsa Crear app; puede pedirte tu contraseña.

La app queda como «Sin publicar». El panel ofrece «Conviértete en proveedor de tecnología»: ignóralo. Solo hace falta para atender datos de otros negocios y exige verificación del negocio.