Integración WhatsApp Business
WhatsApp es el canal principal de comunicación con tus clientes en Synvaxis. Conectar tu número de WhatsApp Business permite que el agente IA responda automáticamente a tus clientes.
Requisitos Previos #
- Cuenta de Meta Business (antes Facebook Business)
- Número de teléfono para usar como WhatsApp Business
- El número no debe estar registrado en WhatsApp personal ni en la app de WhatsApp Business
El número que vincules no podrá seguir usándose en la app de WhatsApp o WhatsApp Business. Se convierte en un número exclusivo de la API de WhatsApp Cloud.
Método de Conexión: Meta Embedded Signup #
Synvaxis utiliza Meta Embedded Signup, el método oficial y simplificado de Meta para conectar WhatsApp Business:
Pasos
- 1Ve a Configuración → Integraciones en tu dashboard
- 2Busca la tarjeta de WhatsApp Business
- 3Haz clic en "Conectar con WhatsApp"
- 4Se abrirá una ventana de Meta donde deberás:
- Seleccionar o crear tu Meta Business Account
- Verificar tu número de WhatsApp Business
- 5Una vez completado, selecciona tu número de WhatsApp de la lista de canales disponibles
- 6Haz clic en "Suscribir al Webhook" para activar la recepción de mensajes
Verificación
Una vez conectado, verás:
- Tu número de WhatsApp vinculado
- Estado de conexión activo
- Número de Phone Number ID asignado
Configuración Manual (Avanzado) #
Si prefieres configurar manualmente, también puedes ingresar las credenciales directamente:
| Campo | Descripción | Dónde obtenerlo |
|---|---|---|
| WhatsApp Token | Token de acceso permanente | Meta Business → API Configuration |
| Phone Number ID | ID del número de WhatsApp | Meta Business → WhatsApp Accounts |
| App Secret | Secreto de la aplicación | Meta Developers → App Settings |
El método de Embedded Signup es más rápido y no requiere crear una app manualmente en Meta Developers. Lo recomendamos para la mayoría de usuarios.
Webhook #
El webhook es la conexión que permite a Synvaxis recibir mensajes en tiempo real:
- Con Embedded Signup, el webhook se configura automáticamente al hacer clic en "Suscribir Webhook"
- Con la configuración manual, necesitas configurar el webhook en Meta Developers apuntando a tu URL de Synvaxis
WhatsApp Cloud API #
Synvaxis utiliza la WhatsApp Cloud API (no la API on-premise). Esto significa:
- ✓ No necesitas un servidor propio para WhatsApp
- ✓ Meta hospeda la infraestructura
- ✓ Actualizaciones automáticas
- ✓ Sin costo adicional por la API (solo el costo de conversaciones de Meta)
Límites de Conversaciones #
Meta tiene sus propios límites para WhatsApp Business:
| Tipo de Conversación | Descripción |
|---|---|
| Iniciada por el usuario | Cuando el cliente escribe primero (ventana de 24h) |
| Iniciada por el negocio | Cuando envías un mensaje usando una plantilla aprobada |
Ventana de 24 Horas
Cuando un cliente te escribe, tienes una ventana de 24 horas para responder libremente. Después de 24 horas, solo puedes responder usando plantillas de mensajes aprobadas por Meta.
Costos de WhatsApp #
Los costos de conversaciones de WhatsApp son cobrados directamente por Meta, no por Synvaxis:
- Las primeras 1,000 conversaciones iniciadas por usuarios son gratis cada mes
- Después se cobra por conversación según la región
- Consulta los precios oficiales de Meta
Desconectar WhatsApp #
Si necesitas desvincular tu número:
- 1Ve a Configuración → Integraciones
- 2En la tarjeta de WhatsApp, haz clic en "Desconectar"
- 3Confirma la desconexión
Preguntas Frecuentes #
¿Puedo usar mi número personal de WhatsApp?
Técnicamente sí, pero ese número dejará de funcionar en la app de WhatsApp. Recomendamos usar un número dedicado para el negocio.
¿Puedo conectar múltiples números de WhatsApp?
La plataforma soporta la selección de canales/números. Consulta con soporte para la configuración de múltiples líneas.
¿Qué pasa si cambio de número?
Puedes desconectar el número actual y conectar uno nuevo siguiendo el mismo proceso.
¿Los mensajes tienen costo?
Synvaxis no cobra por mensaje. El costo de las conversaciones de WhatsApp es de Meta y depende de tu uso y región.
Siguientes Pasos #
- Configuración IA — Configura cómo responde tu agente
- Catálogo de Productos — Agrega productos para que el agente recomiende
- Widget Web — Agrega chat a tu sitio web además de WhatsApp