Saltar a contenido

Tutorial: Configurar la API Oficial de WhatsApp (Meta)

Guía paso a paso para obtener todos los datos necesarios de Meta y conectar la API oficial de WhatsApp a Funnel+.

Requisitos previos

Antes de empezar, necesitás:

  • Una cuenta de Facebook personal (la del dueño o administrador)
  • Una página de Facebook de tu empresa (si no tenés, la creás en el proceso)
  • Un número de teléfono que no esté registrado en WhatsApp (o uno que estés dispuesto a migrar)
  • Acceso a recibir un código de verificación en ese número (SMS o llamada)

Paso 1: Crear una cuenta en Meta Business Suite

Si ya tenés una cuenta de Meta Business, saltá al Paso 2.

  1. Andá a business.facebook.com
  2. Hacé clic en Crear cuenta
  3. Completá:
  4. Nombre de la empresa: El nombre de tu negocio
  5. Tu nombre: Tu nombre real
  6. Email empresarial: Un email de la empresa
  7. Hacé clic en Enviar
  8. Confirmá tu email haciendo clic en el enlace que te llega

Meta Business Suite es gratuito. Es el panel de administración de todos los productos de Meta para empresas.

Paso 2: Crear una App en Meta for Developers

  1. Andá a developers.facebook.com
  2. Iniciá sesión con tu cuenta de Facebook
  3. Hacé clic en Mis Apps (esquina superior derecha)
  4. Hacé clic en Crear App
  5. Seleccioná el tipo: Empresa (Business)
  6. Completá:
  7. Nombre de la app: Ej: Funnel+ WhatsApp
  8. Email de contacto: Tu email
  9. Cuenta de Business: Seleccioná la que creaste en el Paso 1
  10. Hacé clic en Crear app

Agregar el producto WhatsApp

  1. En el panel de la app, buscá WhatsApp y hacé clic en Configurar
  2. Seleccioná tu cuenta de Meta Business cuando te lo pida
  3. Meta crea automáticamente una cuenta de WhatsApp Business (WABA)

Paso 3: Agregar y verificar tu número de teléfono

  1. En el panel de tu app → WhatsApp → Comenzar (Getting Started)
  2. Vas a ver un número de prueba de Meta — ignoralo, vamos a agregar tu número
  3. Hacé clic en Agregar número de teléfono
  4. Completá:
  5. Nombre para mostrar: El nombre que ven tus clientes (ej: "Sabor Criollo")
  6. Categoría: Elegí la que corresponda a tu negocio
  7. Ingresá tu número de teléfono con código de país (+54 para Argentina)
  8. Elegí cómo recibir el código: SMS o Llamada
  9. Ingresá el código de verificación de 6 dígitos
  10. Hacé clic en Verificar

Importante: Si el número ya está en uso en WhatsApp personal, vas a tener que eliminar la cuenta de WhatsApp de ese número antes de verificarlo con la API. Una vez migrado a la API, ya no podés usar WhatsApp normal con ese número.

Paso 4: Obtener el ID del número de teléfono (Phone Number ID)

  1. En tu app → WhatsApp → Configuración de la API (API Setup)
  2. En la sección Desde (From), vas a ver tu número verificado
  3. Debajo del número aparece el Phone Number ID — es un número largo como: 123456789012345
  4. Copiá ese ID — es el que va en el campo "ID del número de teléfono" de Funnel+

Alternativa: 1. Andá a business.facebook.com 2. Menú → Configuración → Cuentas de WhatsApp 3. Hacé clic en tu cuenta → Números de teléfono 4. Ahí aparece el Phone Number ID de cada número

Paso 5: Obtener el ID de la cuenta de WhatsApp Business (WABA ID)

  1. En tu app → WhatsApp → Configuración de la API
  2. En la parte superior, buscá WhatsApp Business Account ID — es otro número largo como: 987654321098765
  3. Copiá ese ID — es el que va en "ID de la cuenta de WhatsApp Business" en Funnel+

Alternativa: 1. En business.facebook.com 2. Menú → Configuración → Cuentas de WhatsApp 3. El WABA ID aparece en la columna de ID

Paso 6: Generar un Token de Acceso permanente

Meta te da un token temporal que dura 24 horas. Para Funnel+ necesitás uno permanente.

Opción A: Token permanente con usuario del sistema (recomendada)

  1. Andá a business.facebook.com
  2. Menú → Configuración → Usuarios del sistema (System Users)
  3. Hacé clic en Agregar para crear un usuario del sistema
  4. Completá:
  5. Nombre: Ej: Funnel+ Bot
  6. Rol: Admin
  7. Hacé clic en Crear usuario del sistema

Asignar permisos

  1. Hacé clic en el usuario que creaste
  2. Hacé clic en Asignar activos
  3. Seleccioná Apps → elegí tu app (ej: Funnel+ WhatsApp)
  4. Activá: Control total
  5. Hacé clic en Guardar cambios
  6. Repetí: Asignar activos → Cuentas de WhatsApp → tu WABA → Control total

Generar el token

  1. Hacé clic en Generar nuevo token
  2. Seleccioná tu app
  3. Marcá estos permisos:
    • whatsapp_business_management
    • whatsapp_business_messaging
  4. Hacé clic en Generar token
  5. Copiá el token inmediatamente — solo se muestra una vez
  6. Guardalo en un lugar seguro — es el que va en "Token de acceso" en Funnel+

Este token no expira. A diferencia del token temporal de la página de API Setup, este token permanente no tiene fecha de vencimiento.

Opción B: Token temporal (solo para pruebas)

  1. En tu app → WhatsApp → Configuración de la API
  2. Copiá el Token de acceso temporal que aparece
  3. Este token vence en 24 horas — no sirve para producción

Paso 7: Configurar en Funnel+

Ahora que tenés todos los datos, volvé a Funnel+:

  1. Canales → Agregar Canal
  2. Seleccioná API oficial
  3. Completá:
Campo Qué poner Ejemplo
Nombre Nombre descriptivo WhatsApp Oficial
Color Color para el canal Azul
ID del número de teléfono Phone Number ID del Paso 4 123456789012345
ID de la cuenta de WhatsApp Business WABA ID del Paso 5 987654321098765
Versión Dejá la que viene por defecto v21.0
Token de acceso Token permanente del Paso 6 EAABx... (token largo)
Token de Webhook Inventá una contraseña MiTokenSeguro2024
  1. Hacé clic en Guardar
  2. Copiá la URL de callback que aparece — la necesitás para el siguiente paso

Paso 8: Configurar el Webhook en Meta

El webhook es lo que permite que los mensajes lleguen de WhatsApp a Funnel+.

  1. Andá a developers.facebook.com → tu app
  2. En el menú lateral → WhatsApp → Configuración
  3. Buscá la sección Webhook y hacé clic en Editar
  4. Completá:
  5. URL de callback: La URL que copiaste de Funnel+ (ej: https://apifunnel.integramas.pro/wabs-webhook/2)
  6. Token de verificación: El mismo texto que pusiste como "Token de Webhook" en Funnel+
  7. Hacé clic en Verificar y guardar

Si la verificación es exitosa, verás un tilde verde.

Suscribirse a los campos del webhook

  1. En la sección de Webhook, buscá messages y activá la suscripción haciendo clic en Suscribir

Los campos recomendados para suscribirse:

Campo ¿Para qué?
messages Recibir mensajes entrantes (obligatorio)
message_deliveries Saber si el mensaje llegó al cliente
message_reads Saber si el cliente leyó el mensaje
messaging_handovers Transferencias entre bots y agentes

Paso 9: Verificar que funciona

  1. Pedile a alguien que envíe un mensaje a tu número de WhatsApp
  2. En Funnel+ → Atenciones, debería aparecer el ticket nuevo
  3. Respondé desde Funnel+ y verificá que el mensaje llega al WhatsApp del cliente

Si no llegan los mensajes: - Verificá que el webhook está verificado en Meta (tilde verde) - Verificá que estás suscrito al campo messages - Verificá que la URL de callback es correcta y accesible desde Internet - Verificá que el Token de acceso no expiró (usá el permanente)

Paso 10: Verificar tu empresa en Meta (para enviar mensajes masivos)

Meta limita los mensajes que podés enviar según tu "tier". Para aumentar el límite:

Niveles de envío (tiers)

Tier Límite Cómo se alcanza
Prueba 250 conversaciones/día Al crear la cuenta
Tier 1 1.000 conversaciones/día Verificar empresa
Tier 2 10.000 conversaciones/día Mantener buena calificación
Tier 3 100.000 conversaciones/día Alto volumen sostenido
Ilimitado Sin límite Excelente calificación mantenida

Verificar tu empresa

  1. En business.facebook.com
  2. Configuración → Centro de seguridad → Verificación de la empresa
  3. Completá la información de tu empresa:
  4. Nombre legal
  5. Dirección
  6. Teléfono
  7. Sitio web
  8. Subí un documento oficial: habilitación comercial, constancia de AFIP (Argentina), o factura de servicios a nombre de la empresa
  9. Meta revisa y aprueba en 2-7 días hábiles

La verificación de empresa es gratuita y te permite subir de tier y acceder a funciones avanzadas.

Costos de la API oficial de Meta

Meta cobra por conversaciones, no por mensajes individuales:

Tipo de conversación ¿Quién la inicia? Costo aproximado (Argentina)
Servicio El cliente escribe primero Gratis
Marketing Vos enviás promoción ~USD 0.05-0.08
Utilidad Vos enviás actualización (tracking, confirmación) ~USD 0.03-0.05
Autenticación Vos enviás código de verificación ~USD 0.02-0.04
  • Cada conversación dura 24 horas desde el primer mensaje
  • Las primeras 1.000 conversaciones de servicio por mes son gratis
  • Los precios varían por país — consultá los precios actualizados de Meta

Plantillas de mensajes (Templates)

Para enviar mensajes fuera de la ventana de 24 horas (el cliente no te escribió en las últimas 24hs), necesitás usar plantillas aprobadas por Meta.

Crear una plantilla

  1. En business.facebook.com
  2. WhatsApp Manager → Plantillas de mensajes
  3. Hacé clic en Crear plantilla
  4. Completá:
  5. Categoría: Marketing, Utilidad o Autenticación
  6. Nombre: Sin espacios, minúsculas (ej: confirmacion_pedido)
  7. Idioma: Español (Argentina)
  8. Diseñá el mensaje:
  9. Podés incluir variables: {{1}}, {{2}}, etc.
  10. Podés agregar botones, imágenes o documentos
  11. Enviar para revisión
  12. Meta aprueba en minutos a 24 horas

Ejemplo de plantillas útiles

Confirmación de turno: 

Hola {{1}}, confirmamos tu turno para el {{2}} a las {{3}}.
Recordá llegar 15 minutos antes.

¿Necesitás reprogramar?
[Botón: Sí, reprogramar] [Botón: Confirmo asistencia]

Seguimiento de pedido: 

¡Hola {{1}}! Tu pedido #{{2}} está {{3}}.
Estimado de entrega: {{4}}.

¿Necesitás ayuda?
[Botón: Hablar con un asesor]

Promoción: 

¡Hola {{1}}! Esta semana tenemos {{2}}.
No te lo pierdas.

[Botón: Ver ofertas] [Botón: No me interesa]

En Funnel+, las Campañas y Programaciones pueden usar estas plantillas para enviar mensajes masivos por la API oficial.

Resumen: Los 4 datos que necesitás

Dato Dónde se obtiene Campo en Funnel+
Phone Number ID App → WhatsApp → API Setup → sección "Desde" ID del número de teléfono
WABA ID App → WhatsApp → API Setup → parte superior ID de la cuenta de WhatsApp Business
Token permanente Business Suite → Usuarios del sistema → Generar token Token de acceso
Token de Webhook Lo inventás vos (contraseña segura) Token de Webhook

Solución de problemas

Problema Solución
"Error al verificar webhook" Verificá que la URL de callback sea accesible desde Internet (HTTPS) y que el token coincida exactamente
No llegan mensajes Verificá la suscripción al campo messages en la configuración del webhook
"Token expirado" Usá un token permanente (Opción A del Paso 6), no el temporal
"Número no verificado" Repetí el proceso de verificación del número (Paso 3)
No puedo enviar mensajes masivos Verificá tu empresa (Paso 10) y usá plantillas aprobadas
"Rate limit exceeded" Estás superando tu tier. Verificá la empresa para subir de nivel
Los mensajes salen pero no llegan Verificá que el número del cliente no te bloqueó y que tu calificación de calidad es buena