Integración con WhatsApp
Conecta tu cuenta de WhatsApp Business a PropPilot y deja que tu agente de IA responda a los clientes en WhatsApp.
Requisitos previos
Antes de configurar WhatsApp:
- ✅ Chatwoot conectado (consulta Configuración de Chatwoot)
- ✅ Cuenta de Meta Business
- ✅ Cuenta de WhatsApp Business (WABA)
- ✅ Acceso a Meta Business Suite
WhatsApp Business Cloud API
PropPilot usa la WhatsApp Business Cloud API (no la app de WhatsApp Business). Es la API oficial de Meta para que las empresas envíen y reciban mensajes a escala.
Diferencias clave
| Funcionalidad | App de WhatsApp Business | WhatsApp Cloud API |
|---|---|---|
| Mensajes | Manuales | Automatizados vía API |
| Escala | Un solo dispositivo | Ilimitada |
| Integración con IA | No | Sí (PropPilot) |
| Coste | Gratis | Pago por conversación |
Obtener tus credenciales
Paso 1: Accede a Meta Business Suite
- Ve a business.facebook.com
- Inicia sesión con tu cuenta de Meta
- Ve a tu negocio
Paso 2: Crea una cuenta de WhatsApp Business
Si no tienes una:
- Ve a Business Settings → Accounts → WhatsApp accounts
- Haz clic en Add → Create a WhatsApp Business Account
- Sigue el asistente de configuración
- Verifica tu número de teléfono
Paso 3: Obtén las credenciales de la API
Desde Meta Business Suite:
- Ve a WhatsApp → Getting Started
- Encuentra estas credenciales:
| Credencial | Dónde encontrarla |
|---|---|
| Access Token | API Setup → Token temporal o permanente |
| Phone Number ID | API Setup → Phone Number ID |
| Business Account ID | API Setup → WhatsApp Business Account ID |
Tipos de token
- Token temporal: caduca en 24 horas (bueno para pruebas)
- Token permanente: token de System User (recomendado para producción)
Para producción, crea un System User y genera un token permanente.
Configurar en PropPilot
Paso 1: Ve a la configuración de WhatsApp
- Ve a Integrations → pestaña Chatwoot
- Encuentra la tarjeta del canal WhatsApp Cloud
- Haz clic en Configure o Connect
Paso 2: Introduce las credenciales
| Campo | Descripción |
|---|---|
| Phone Number | Tu número de WhatsApp Business (con prefijo de país) |
| Access Token | Tu token de acceso a la API de Meta |
| Phone Number ID | El ID de tu número de WhatsApp |
| Business Account ID | Tu WABA ID |
| Inbox Name | Nombre visible en PropPilot (opcional) |
Paso 3: Guarda y obtén los datos del webhook
- Haz clic en Save para crear el canal
- PropPilot genera automáticamente:
- Webhook URL - La URL de callback para Meta
- Webhook Verify Token - Un token aleatorio seguro para la verificación
- Copia ambos valores para el siguiente paso
Token autogenerado
No necesitas crear un verify token manualmente. PropPilot genera un token aleatorio seguro automáticamente al guardar la configuración del canal.
Configurar webhooks en Meta
Paso 1: Accede a la configuración de webhooks
- Ve a Meta Business Suite
- Ve a WhatsApp → Configuration → Webhooks
- Haz clic en Configure (o Edit si ya está configurado)
Paso 2: Introduce los datos del webhook
| Campo | Valor |
|---|---|
| Callback URL | La URL del webhook desde PropPilot |
| Verify Token | El verify token autogenerado desde PropPilot |
Paso 3: Suscríbete a los eventos
Selecciona estos campos del webhook:
- ✅
messages - ✅
message_status(opcional, para confirmaciones de entrega)
Paso 4: Verificar
Haz clic en Verify and Save. Meta enviará una solicitud de verificación a PropPilot.
Probar la conexión
- Vuelve a PropPilot Integrations → Chatwoot
- El canal de WhatsApp debería mostrar Connected
- Haz clic en Test para verificar la conectividad
- Envía un mensaje desde WhatsApp a tu número de empresa
- Comprueba que aparece en el inbox de PropPilot
Habilitar tu agente
Para que tu agente de IA responda en WhatsApp:
- Ve a Agents → Selecciona tu agente
- Ve a la pestaña Channels
- Activa el bot en el canal WhatsApp
Políticas de WhatsApp
Ventana de 24 horas
WhatsApp tiene una ventana de mensajería de 24 horas:
- Tras un mensaje del cliente, tienes 24 horas para responder
- Pasadas las 24 horas, solo puedes enviar mensajes de plantilla (preaprobados)
- Las respuestas de la IA cuentan dentro de la ventana
Mensajes de plantilla
Para mensajes fuera de la ventana de 24 horas:
- Deben usar plantillas preaprobadas
- Las plantillas las aprueba Meta
- Contacta con soporte para configurar plantillas
Verificación de empresa
Para mejor entregabilidad:
- Completa la verificación de empresa en Meta
- Aprobación del nombre visible
- Añade el badge verde (opcional, para empresas más grandes)
Resolución de problemas
Falla la verificación del webhook
- Copia el verify token desde PropPilot exactamente (usa el botón de copiar)
- Asegúrate de que la URL del webhook de PropPilot es correcta y completa
- Comprueba que no haya espacios extra al pegar
- Prueba a desconectar y reconectar el canal para regenerar los tokens
Los mensajes no llegan
- Verifica que la suscripción del webhook incluye
messages - Comprueba que el estado del canal es Connected
- Revisa los logs de entrega del webhook en Meta
- Asegúrate de que el número de teléfono está verificado
Errores de la API
Problemas habituales:
- Token inválido: regenera el access token
- Rate limited: has superado los límites de la API
- Plantilla requerida: la ventana de 24 horas ha caducado
Costes
El precio de WhatsApp Cloud API se basa en conversaciones:
| Tipo | Descripción | Coste |
|---|---|---|
| Iniciada por el usuario | El cliente te escribe primero | Coste menor |
| Iniciada por la empresa | Tú escribes al cliente primero | Coste mayor |
Los costes varían por país. Consulta la página de precios de Meta para más detalles.
¿Qué sigue?
- Configuración de Telegram - Añade otro canal
- Canales del agente - Habilita tu agente