WhatsApp Web y Evolution API
- Los dos tipos de canal de WhatsApp no oficiales disponibles en AutoTalk
- Cómo configurar WhatsApp Web (conexión por escaneo)
- Cómo configurar Evolution API (gateway de WhatsApp auto-hospedado)
- Cómo configurar un proxy para conexiones de WhatsApp Web
- 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 bloques separados en el selector de tipo de canal cuando agregas un nuevo canal.
Opción 1: WhatsApp Web
Etiqueta del bloque: WhatsApp Web
Esta opción funciona 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 Web
- 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 Web
- En la barra lateral, ve a Integraciones > Canales.
- Haz clic en Agregar canal.
- En el selector de tipo de canal, selecciona el bloque WhatsApp Web (en el grupo WhatsApp).
- En la pantalla de configuración, opcionalmente completa Número de WhatsApp (opcional) — solo se usa para identificar la instancia en tu lista de canales.
- En Confirmaciones, marca ambas casillas (el costo de la conexión alojada y el aviso de riesgo de baneo). El botón permanece bloqueado hasta que las confirmes.
- Haz clic en Crear canal y generar QR. El canal se crea deshabilitado y se te lleva a su página, donde aparece el código QR.
- 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, la sesión se pone en línea y el estado del canal cambia a conectado. La medición comienza una vez que la sesión está en línea.
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 del bloque: 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 selector de tipo de canal, selecciona el bloque 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
Los canales de WhatsApp Web soportan un proxy opcional para enrutar la conexión 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. (Los canales de Evolution API no exponen configuración de proxy — configura cualquier proxy en tu propio servidor de Evolution.)
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 (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 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 el botón Aplicar Proxy se active. Si aparece deshabilitado, guarda primero.
Eliminar un proxy
Aplicar Proxy solo envía un proxy configurado a la conexión activa — no puede des-aplicar uno, y una vez que el campo Host está vacío el botón deja de estar disponible. Para dejar de usar un proxy, vuelve a crear la sesión sin él:
- Limpia los campos de proxy (como mínimo Host) en Configuración de Proxy y guarda el canal.
- Haz clic en Eliminar sesión de WhatsApp Web/Evolution para desconectar la sesión actual. El canal en sí se conserva y se marca como deshabilitado.
- Haz clic en Crear sesión de WhatsApp Web/Evolution y escanea el código QR de nuevo. La nueva sesión se conecta sin el proxy.
Comparación: WhatsApp Web vs. Evolution API vs. API Oficial
| Característica | WhatsApp Web | Evolution API | WhatsApp API (Oficial) |
|---|---|---|---|
| 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 en la app | Sí | No | 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 Web 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.
Enviar tarjetas de contacto y encuestas vía API
Tanto los canales de WhatsApp Web como los de Evolution API admiten dos tipos de mensaje estructurados además de texto y multimedia: tarjetas de contacto y encuestas. Ambos se envían a través del endpoint de envío de la conversación del profesional, que recibe un array messages donde los campos de cada elemento van en el nivel superior (no hay un envoltorio body):
POST /messaging/employee/:employeeId/conversation/:conversationId/message
Los ejemplos siguientes se autentican con las cookies de tu sesión de inicio de sesión. Las solicitudes de escritura autenticadas por sesión también deben pasar una verificación CSRF de doble envío: envía la cookie csrf emitida al iniciar sesión y repite su valor en el encabezado x-csrf-token, junto con la cookie de acceso at. Las solicitudes que presentan la cookie at sin el par CSRF correspondiente son rechazadas con 403 csrf_failed.
Tarjetas de contacto (type: "contacts")
curl -X POST "https://run.autotalk.io/messaging/employee/{EMPLOYEE_ID}/conversation/{CONV_ID}/message" \
-H "Content-Type: application/json" \
-H "x-csrf-token: $CSRF" \
--cookie "at=$AT; csrf=$CSRF" \
-d '{
"messages": [
{
"type": "contacts",
"text": "Leyenda opcional encima de las tarjetas",
"contacts": [
{
"displayName": "Alice Reyes",
"phones": [{"phone": "5511987654321", "waId": "5511987654321", "type": "mobile"}],
"emails": [{"email": "[email protected]", "type": "work"}],
"org": {"company": "Example Co."}
}
]
}
]
}'
Límites: al menos una tarjeta, hasta 10 por mensaje. Cada tarjeta requiere displayName y un teléfono (o waId).
Encuestas (type: "poll")
curl -X POST "https://run.autotalk.io/messaging/employee/{EMPLOYEE_ID}/conversation/{CONV_ID}/message" \
-H "Content-Type: application/json" \
-H "x-csrf-token: $CSRF" \
--cookie "at=$AT; csrf=$CSRF" \
-d '{
"messages": [
{
"type": "poll",
"title": "¿Color favorito?",
"name": "¿Color favorito?",
"question": "¿Color favorito?",
"options": [
{"label": "Rojo", "value": "Rojo"},
{"label": "Azul", "value": "Azul"},
{"label": "Verde", "value": "Verde"}
],
"selectableCount": 1
}
]
}'
Límites: 2 a 10 opciones únicas no vacías. selectableCount entre 1 y options.length (por defecto 1 = elección única).
Acciones específicas del canal
La página del canal expone widgets que envuelven llamadas a la Evolution API con respuestas formateadas y filtradas. También se pueden invocar como funciones Dynadata en la colección channels:
| Acción | Función | Límites |
|---|---|---|
| Verificar qué números existen en WhatsApp | checkWhatsappWebEvoNumbers({numbers}) | hasta 100 números por solicitud; 50/min, 500/h, 2000/día por empresa |
| Listar grupos, buscar por invitación, crear grupo | fetchWhatsappWebEvoGroups, findWhatsappWebEvoGroupByInviteCode, createWhatsappWebEvoGroup | 60 lecturas/min por canal; 5 creaciones por hora por canal |
Todas las respuestas están formateadas — el backend nunca devuelve datos brutos de Evolution, metadatos de instancia, URLs internas, claves de API, detalles de webhook o credenciales de proxy.
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