Guía
WhatsApp Business API: cómo conectarla paso a paso
Publicado el 18 de septiembre de 2026 · Kivaro, Buenos Aires
La API oficial es lo que permite que un sistema conteste tu WhatsApp sin un celular prendido en un rincón. Conectarla no es difícil, pero tiene cinco o seis puntos donde todo el mundo se traba. Esta guía los ordena, con lo que aprendimos conectando números reales este año.
Antes que nada: qué es y qué no es
- WhatsApp Business (la app del celular) es para atender a mano. No se automatiza de verdad.
- La API de WhatsApp Business (Cloud API) es un servicio de Meta al que se conecta un sistema. Sin app: los mensajes van y vienen por internet.
- Un número está en una o en la otra. Las dos a la vez solo lo habilitan los proveedores oficiales de Meta, así que en la práctica conviene un número libre.
Paso 1: elegir el número
Necesitás una línea que no esté registrada en la app de WhatsApp. Si vas a usar un número que hoy usás, primero hay que borrar esa cuenta, con sus chats. Dos avisos por experiencia:
- Evitá líneas prepagas recicladas. Si el dueño anterior fue suspendido en WhatsApp, el número puede quedar bloqueado apenas lo registrás, y la revisión de Meta tarda.
- El chip tiene que poder recibir SMS o llamadas para el código de verificación. Después podés guardarlo: el sistema no lo necesita para funcionar.
Paso 2: crear la app y la cuenta de WhatsApp en Meta
En el panel para desarrolladores de Meta se crea una app de tipo empresa y se le agrega el producto WhatsApp. Ahí aparece un número de prueba que sirve para probar, pero solo le contesta a una lista corta de celulares autorizados. El número real se agrega en el Administrador de WhatsApp, dentro de una cuenta a nombre de tu empresa.
Tres cosas que conviene dejar listas desde el principio:
- La app en modo Activo. En modo desarrollo no llegan los mensajes reales, y se pierde mucho tiempo buscando el error donde no está.
- Política de privacidad publicada y una página que explique cómo pedir la eliminación de datos: Meta las exige.
- Un token permanente, de un usuario del sistema. Los tokens temporales vencen en 24 horas y un día el bot deja de contestar.
Paso 3: el webhook
Es la dirección de internet a la que Meta manda cada mensaje entrante. Necesita HTTPS y responder rápido. Dos detalles que evitan dolores de cabeza:
- Validá la firma de cada mensaje con la clave secreta de la app. Si no, cualquiera que descubra tu dirección puede inventar conversaciones.
- Contestá el webhook al instante y pensá la respuesta aparte. Meta reintenta si tardás, y el cliente recibe la respuesta dos veces.
- Suscribí la cuenta de WhatsApp a tu app. Es el paso que más se olvida: los mensajes se ven en el panel de Meta pero nunca llegan a tu sistema.
Paso 4: verificación del negocio y límites
Sin verificar la empresa, Meta te deja tener hasta 2 números y limita las conversaciones que puede iniciar la empresa. La verificación pide documentación a nombre del negocio: constancia fiscal, domicilio y teléfono que coincidan. Si sos monotributista, la constancia de inscripción suele alcanzar; si no estás inscripto, la verificación no va a salir.
Paso 5: los errores que más tiempo hacen perder
| Síntoma | Qué suele ser |
|---|---|
| No llega ningún mensaje al sistema | La app está en modo desarrollo, o la cuenta de WhatsApp no está suscripta a la app |
| Error 131030 al responder | Número de prueba: el destinatario no está en la lista de autorizados |
| Números argentinos que rebotan | Llegan como 549… y hay que responder con el formato viejo: 54 + característica + 15 + abonado |
| El número figura bloqueado apenas se registra | Línea reciclada con historial. Se pide revisión a Meta |
| Deja de contestar de un día para el otro | Token temporal vencido |
| No se puede escribir a un cliente viejo | Pasaron 24 horas: hace falta una plantilla aprobada, y se cobra |
Qué se cobra
Responder a quien te escribe, dentro de las 24 horas, no tiene costo de Meta. Se cobran los mensajes que inicia la empresa, que además necesitan plantillas aprobadas. El detalle está en cuánto cuesta un chatbot de WhatsApp en Argentina.
¿Preferís no pelearte con esto? En Kivaro hacemos el alta completa a nombre de tu empresa y te entregamos el WhatsApp atendido, con bandeja y avisos. Mirá cómo funciona.
Preguntas frecuentes
¿Puedo seguir usando la app con el mismo número?
No a la vez. Un número está en la app o en la API. Lo habitual es dejar el número conocido en la app para el equipo y usar una línea nueva para la atención automática, o migrar el número y avisarlo.
¿Hace falta un servidor propio?
No necesariamente. Se puede correr en servicios en la nube con plan gratuito, siempre que respondan rápido y estén siempre disponibles.
¿Cuánto tarda la verificación del negocio?
Entre 2 y 5 días hábiles si la documentación coincide con los datos cargados. Si algo no coincide, la rechazan y hay que volver a enviarla.
¿Lo conectamos nosotros?
Quince minutos alcanzan para saber si tu número sirve y qué lleva conectarlo.