WhatsApp Web y Evolution API
- Los dos tipos de canal de WhatsApp no oficiales disponibles en AutoTalk
- Cómo configurar WhatsApp QR Code (conexión por escaneo)
- Cómo configurar Evolution API (gateway de WhatsApp auto-hospedado)
- Cómo configurar un proxy para conexiones de WhatsApp
- Cómo elegir entre ellos
AutoTalk ofrece dos opciones de canal de WhatsApp que no requieren la aprobación de la API oficial Business de Meta. Ambas aparecen como opciones separadas en el menú desplegable de tipo de canal cuando agregas un nuevo canal.
Opción 1: WhatsApp QR Code
Etiqueta en el menú: WhatsApp QR Code
Esta opción funciona exactamente como WhatsApp Web en una computadora de escritorio. Escaneas un código QR con tu teléfono, y AutoTalk refleja tu sesión de WhatsApp para recibir y enviar mensajes.
Cuándo usar WhatsApp QR Code
- Quieres la configuración más rápida posible sin cuentas externas ni claves de API
- Eres un pequeño negocio u operador individual con volúmenes moderados de mensajes
- No necesitas plantillas de mensajes ni funciones de la API oficial
Configurar WhatsApp QR Code
- En la barra lateral, ve a Integraciones > Canales para abrir la lista de Canales.
- Haz clic en Agregar canal.
- En el menú desplegable de tipo de canal, selecciona WhatsApp QR Code.
- Aparecerá un código QR en la pantalla.
- En tu teléfono, abre WhatsApp y ve a Configuración > Dispositivos vinculados > Vincular un dispositivo.
- Escanea el código QR mostrado en AutoTalk con la cámara de tu teléfono.
- Cuando el escaneo se complete, el estado del canal cambia a conectado.
Consideraciones importantes
- Tu teléfono debe permanecer conectado a internet para que la sesión vinculada se mantenga activa.
- Si la conexión se cae (por ejemplo, si tu teléfono pierde internet por un período prolongado), puede ser necesario escanear un nuevo código QR.
- Este método es mejor para volúmenes pequeños a medianos de mensajes. Para uso de alto volumen, considera la API oficial de WhatsApp Business.
- Si el código QR expira antes de que lo escanees, actualiza la página o el elemento del código QR para generar uno nuevo.
Opción 2: Evolution API
Etiqueta en el menú: Evolution API
Evolution API es un gateway de WhatsApp auto-hospedado. En lugar de depender de la infraestructura en la nube de Meta, tú (o tu equipo de TI) ejecutas el servidor de Evolution API, y AutoTalk se conecta a él. Esto te da más control sobre la conexión de WhatsApp, incluyendo dónde se almacenan los datos y cómo se gestiona la sesión.
Cuándo usar Evolution API
- Tu organización requiere infraestructura auto-hospedada por razones de cumplimiento o soberanía de datos
- Quieres más control técnico sobre la conexión de WhatsApp
- Tienes un equipo de TI que puede implementar y mantener el servidor de Evolution API
Configurar Evolution API
- Implementa una instancia de Evolution API en tu propio servidor o infraestructura en la nube. Consulta la documentación del proyecto Evolution API para los pasos de instalación.
- En AutoTalk, ve a Integraciones > Canales y haz clic en Agregar canal.
- En el menú desplegable de tipo de canal, selecciona Evolution API.
- Ingresa los campos de configuración que aparecen, incluyendo la URL del servidor de Evolution API y cualquier credencial de autenticación requerida.
- Guarda el canal.
- Sigue las instrucciones para vincular la instancia de Evolution API con tu número de WhatsApp (esto puede implicar escanear un código QR en el lado de Evolution API).
Consideraciones importantes
- Tú eres responsable de alojar, actualizar y mantener el servidor de Evolution API.
- El tiempo de actividad del canal depende del tiempo de actividad de tu servidor auto-hospedado.
- Esta opción ofrece la mayor flexibilidad y control, pero también requiere la mayor participación técnica.
Configuración de Proxy
Tanto los canales de WhatsApp QR Code como de Evolution API soportan un proxy opcional para enrutar las conexiones de WhatsApp a través de un servidor intermediario. Esto es útil cuando la IP de tu servidor está bloqueada, cuando necesitas rotar IPs, o cuando la política de la empresa requiere que el tráfico saliente pase por un proxy.
La sección de proxy aparece como un panel desplegable etiquetado Configuración de Proxy dentro de la página de edición del canal.
Configurar un proxy
- Abre la página de edición del canal (Integraciones > Canales, luego haz clic en el canal).
- Expande la sección Configuración de Proxy.
- Completa los campos:
| Campo | Descripción | Ejemplo |
|---|---|---|
| Host | Nombre de host o dirección IP del servidor proxy | brd.superproxy.io |
| Puerto | Número de puerto | 33335 |
| Protocolo | Protocolo de conexión | http, https, socks4 o socks5 |
| Usuario | Nombre de usuario de autenticación (dejar en blanco si no es necesario) | brd-customer-abc123 |
| Contraseña | Contraseña de autenticación, almacenada como secreto de seguridad | Escribe la contraseña y haz clic en Agregar para crear el secreto |
- Haz clic en Guardar para guardar el canal.
- Haz clic en Probar Proxy para verificar que el proxy es accesible.
- Haz clic en Aplicar Proxy para aplicar la configuración de proxy a la conexión activa de WhatsApp.
El campo Contraseña almacena tus credenciales de proxy como un secreto de seguridad encriptado. Cuando escribes una contraseña y haces clic en Agregar (o seleccionas la opción de crear en el menú desplegable), el secreto se crea automáticamente -- no necesitas llenar ningún formulario adicional.
Debes guardar el canal antes de que los botones Probar Proxy y Aplicar Proxy se activen. Si los botones aparecen deshabilitados, guarda primero.
Eliminar un proxy
Para dejar de usar un proxy, limpia el campo Host, guarda el canal y haz clic en Aplicar Proxy para aplicar el cambio a la conexión activa.
Comparación: QR Code vs. Evolution API vs. API Oficial
| Característica | WhatsApp QR Code | Evolution API | WhatsApp API (Official) |
|---|---|---|---|
| Dificultad de configuración | Muy fácil | Moderada a avanzada | Moderada |
| Aprobación de Meta requerida | No | No | Sí |
| Auto-hospedado | No | Sí | No |
| Teléfono debe permanecer en línea | Sí | Depende de la configuración | No |
| Plantillas de mensajes | No | No | Sí |
| Soporte de proxy | Sí | Sí | No |
| Ideal para | Inicio rápido, equipos pequeños | Equipos técnicos, necesidades de cumplimiento | Alto volumen, uso oficial |
Si no estás seguro de qué opción elegir, comienza con WhatsApp QR Code para una prueba rápida. Siempre puedes migrar a la API oficial de WhatsApp Business o Evolution API después, a medida que crezcan tus necesidades.
Próximos pasos
- WhatsApp Business (API Oficial) — Configura la integración oficial aprobada por Meta
- Agregar una integración — Guía general de configuración de canal