Widget de Llamada de Vuelta
El Widget de Llamada de Vuelta es un pequeño formulario embebible que permite a los visitantes de tu sitio web dejar su número de teléfono y recibir una llamada de vuelta de tu agente de voz IA, normalmente en cuestión de segundos. En lugar de pedir a los visitantes que marquen, la conversación va hacia ellos.
Este es el quinto tipo de widget, junto a los widgets Flotante, Pill, Inline y Popup, pero funciona de forma muy distinta. Los otros widgets inician una conversación de voz en el navegador. El Widget de Llamada de Vuelta encola una llamada telefónica real realizada por tu agente a través de tu número saliente.
Cuándo Usarlo
| Escenario | Por qué encaja el Widget de Llamada de Vuelta |
|---|---|
| Landing pages de generación de leads | El visitante se compromete con un número y el agente lo califica en el minuto siguiente |
| Páginas de producto de alta intención | "Hablar con un especialista" sin que el visitante tenga que marcar |
| Sitios mobile-first | Un toque en el pill, sin permisos, sin necesidad de auriculares |
| Cobertura fuera de horario | El visitante deja su número fuera de horas y el agente marca cuando la cola abre |
| Menor fricción que los formularios | Los visitantes envían un único campo y reciben una respuesta instantánea |
Requisitos
El Widget de Llamada de Vuelta requiere tres cosas en tu cuenta antes de poder activarse:
| Requisito | Por qué |
|---|---|
| Plan de pago (Starter o superior) | Los minutos salientes consumidos durante la llamada de vuelta se facturan por minuto |
| Número de teléfono saliente verificado asignado al agente | El agente necesita un número real desde el que marcar |
| Email verificado en tu workspace | Confirma la propiedad antes de habilitar las llamadas salientes |
Si falta alguno, la sección del widget Callback en la pestaña Widgets del agente muestra una alerta indicándote exactamente qué corregir. El widget permanece deshabilitado hasta que los tres estén en orden.
El Widget de Llamada de Vuelta no está disponible en el plan Free porque realiza llamadas telefónicas salientes. Todos los demás tipos de widget (Flotante, Pill, Inline) siguen siendo gratuitos.
Configuración
1. Activar la llamada de vuelta en el agente
- Abre tu agente y ve a la pestaña Widgets.
- Desplázate hasta la sección Widget de llamada de vuelta.
- Activa "Habilitar widget de llamada de vuelta".
- Configura:
- Intentos de reintento: cuántas veces reintenta el agente si el visitante no contesta (1–5, por defecto 3).
- Intervalo entre reintentos: minutos entre intentos (1–30, por defecto 5).
- Idioma del widget: el idioma en el que el formulario, los mensajes de estado y el selector de país se muestran al visitante (14 idiomas disponibles; ver más abajo).
- Tema: paleta de colores para el pill flotante y el diálogo (usa la misma paleta de temas que los otros widgets).
- Guarda.
Junto a la configuración aparece una vista previa en vivo del widget para que veas los cambios al instante, sin necesidad de desplegar para probar el aspecto.
2. Copia el snippet de embed
En la misma sección, copia el snippet HTML:
<hanc-ai-callback agent-id="YOUR_AGENT_ID"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async type="text/javascript"></script>
Pégalo una vez en tu sitio web, normalmente justo antes de </body>. El widget aparece como un pill flotante en la esquina de la página.
La etiqueta @latest significa que tu sitio adopta automáticamente las nuevas versiones del widget cuando se publican. Fija una versión específica (por ejemplo hanc-webrtc-widgets@1.4.0) si quieres control total sobre las actualizaciones.
Lo Que Ve el Visitante
El widget guía al visitante a través de cuatro estados:
| Estado | Lo que ve el visitante |
|---|---|
| Formulario | Pill flotante en la esquina. Clic para abrir. Selector de país a la izquierda, input de teléfono a la derecha, botón de envío. |
| En cola | "Estás en la cola: unos N segundos hasta que te llamemos." Se actualiza en vivo. |
| Llamando | "Te estamos llamando ahora." Permanece hasta que la llamada conecta o falla. |
| Completado / Fallido | Una breve confirmación o un error amistoso con una indicación de "recarga la página para hacer otra llamada de vuelta". |
El formulario auto-valida el número de teléfono contra el formato nacional del país elegido y se niega a enviar a menos que el número sea plausible.
Cobertura de países
El selector de país cubre Europa (UE + DACH + Reino Unido), Norteamérica (EE. UU. + Canadá) y un conjunto seleccionado de países adicionales ampliamente soportados. Cada país muestra su bandera, nombre y un placeholder de ejemplo en el formato nativo para que el visitante sepa qué escribir.
Si un país que usan tus visitantes no aparece, contacta a support@hanc.ai; la cobertura se amplía regularmente.
Atributos HTML
El widget acepta estos atributos en la etiqueta <hanc-ai-callback>:
| Atributo | Requerido | Descripción |
|---|---|---|
agent-id | Sí | Identificador único de tu agente |
locale | No | Sobrescribe el idioma de la UI del widget para esta página (por ejemplo locale="de"). Útil si tu sitio es multilingüe y el locale de la página no coincide con el predeterminado del agente. |
theme | No | Sobrescribe el tema de color para esta página |
position | No | Dónde se ancla el pill flotante (bottom-right, bottom-left, top-right, top-left) |
Cualquier cosa que omitas usa por defecto lo que hayas configurado en el agente desde el dashboard.
Ejemplo: página en alemán en un sitio multilingüe
<hanc-ai-callback agent-id="YOUR_AGENT_ID" locale="de"></hanc-ai-callback>
<script src="https://unpkg.com/hanc-webrtc-widgets@latest" async></script>
El texto del pill, las etiquetas del diálogo, el selector de país y los mensajes de estado pasan todos a alemán. El propio agente sigue hablando en el idioma para el que esté configurado; locale solo afecta a lo que el visitante lee en la página.
Idioma del Widget
La UI del widget incluye 14 idiomas integrados:
| Código | Idioma |
|---|---|
en | English |
de | Deutsch |
fr | Français |
es | Español |
it | Italiano |
pt | Português |
pl | Polski |
cs | Čeština |
hu | Magyar |
tr | Türkçe |
kk | Қазақша |
zh | 中文 |
ru | Русский |
uk | Українська |
El agente escoge su idioma de tres lugares, en este orden de prioridad:
- El atributo
locale="…"en el embed (mayor prioridad) - El Idioma del widget configurado en la pestaña Widgets del agente
- Inglés (por defecto)
El idioma del widget solo afecta al texto en pantalla que lee el visitante: etiquetas, selector de país y mensajes de estado. La conversación de voz real se produce en el idioma que tu agente esté configurado para hablar.
Comportamiento de Reintento
Si el visitante no contesta en el primer intento, el agente espera el intervalo configurado y vuelve a marcar, hasta el número de intentos configurado.
- Intentos: 1–5 (por defecto 3)
- Intervalo: 1–30 minutos (por defecto 5)
El widget muestra al visitante el estado de cada intento. Tras agotar todos los intentos, el widget cambia al estado "no pudimos contactarte" con un mensaje cordial.
Tres intentos con cinco minutos de intervalo funciona bien para la mayoría de landing pages de generación de leads: lo suficientemente rápido como para que el visitante siga navegando, lo suficientemente suave como para no resultar insistente. Súbelo si tu audiencia tiende a ignorar números desconocidos.
Una Llamada de Vuelta por Carga de Página
Una vez que el visitante envía su número, el widget se bloquea durante el resto del ciclo de vida de esa página:
- Cerrar el diálogo colapsa el pill pero no reinicia el formulario.
- Reabrirlo muestra el estado actual (en cola / llamando / completado / fallido), no un formulario nuevo.
- Para hacer una segunda llamada de vuelta, el visitante debe recargar la página.
Esto evita envíos duplicados accidentales mientras una llamada ya está en curso. Si el visitante cancela explícitamente su llamada de vuelta en cola desde el diálogo (botón "Cancelar" en la pantalla "en cola"), el bloqueo se libera y puede volver a enviar inmediatamente.
¿Qué pasa si recarga durante la llamada de vuelta?
Si un visitante recarga la página mientras el agente todavía está reintentando su número, el widget detecta que ya existe una llamada de vuelta activa para el mismo número y se reconecta silenciosamente a ella: sin marcado duplicado, sin segunda entrada en cola. El visitante simplemente ve su estado existente continuar desde donde se quedó.
Concurrencia y Capacidad
Un único agente puede tener hasta 10 llamadas de vuelta en curso al mismo tiempo. Los envíos por encima de ese número esperan en la cola y se marcan a medida que se libera capacidad.
El bucle de agente-liberado-luego-marcar drena la cola continuamente: la mayoría de los visitantes son llamados a los pocos segundos de enviar si no estás cerca del tope de concurrencia.
Existe un límite de tasa por número (un número solo puede encolarse unas pocas veces por hora para el mismo agente) para prevenir abusos. Los visitantes que lo alcanzan ven un mensaje cordial de "estaremos en contacto en breve" en lugar de la pantalla "en cola".
Vista Previa en Vivo en el Dashboard
La pestaña Widgets muestra una vista previa en vivo del widget de llamada de vuelta junto a la configuración. Cualquier cambio que hagas (tema, idioma, números de reintento) actualiza la vista previa al instante. No tienes que desplegar tu sitio para ver cómo lucirá el widget.
La vista previa usa un manifiesto simulado con la lista completa de países y elegibilidad de demo, de modo que el widget se renderiza incluso en planes donde las llamadas de vuelta salientes aún no están disponibles.
Tracking Embebido
El widget emite los mismos eventos call-start y call-end que los otros widgets. Escúchalos en JavaScript si quieres disparar tu propia analítica:
const widget = document.querySelector('hanc-ai-callback');
widget.addEventListener('call-start', () => {
// La llamada de vuelta del visitante se acaba de conectar — trackea como conversión
});
widget.addEventListener('call-end', () => {
// Llamada de vuelta finalizada — trackea duración, resultado, etc.
});
Disponibilidad por Plan
| Plan | Widget de Llamada de Vuelta |
|---|---|
| Free | No disponible (requiere llamadas salientes) |
| Starter / Pro / Business / Enterprise | Disponible |
Todos los planes de pago obtienen el mismo conjunto de funciones del widget. El coste por llamada sigue tu tarifa saliente habitual; consulta Facturación.
Relacionado
- Widgets de Sitio Web: tipos de widget Flotante, Pill, Inline y Popup para conversaciones en el navegador
- Configuración: ajustes de llamada del agente incluyendo Duración Máxima de Llamada que también limita las llamadas de vuelta
- Números de Teléfono: conecta el número saliente desde el que marcará tu widget de llamada de vuelta
- FAQ: preguntas frecuentes y casos límite