Canales de voz
Por Sojan
Por Sojan
Aprende a conectar proveedores de voz, gestionar llamadas entrantes y configurar la atención telefónica en Chatwoot.
Llamadas de voz en Chatwoot
Habla con tus clientes por voz, directamente desde la misma bandeja de entrada donde ya gestionas los chats. Esta guía está dividida en tres partes: 1. Qué es la llamada de voz y cómo ayuda: descripción general sobre la función de llamada de voz 2. Conectando un canal de voz: configuración para cada proveedor (Twilio y WhatsApp) 3. Uso diario de llamadas de voz: responder, asignaciones, quién recibe la llamada y qué sucede después de una llamada 1. Qué es la llamada de voz y cómo ayuda La llamada de voz permite que tus agentes realicen y reciban llamadas telefónicas dentro de Chatwoot, sin tener que manejar una aplicación de teléfono separada. Una llamada vive en el mismo lugar que el resto de la conversación, por lo que el historial de chat, los detalles de contacto, las notas y la llamada se encuentran juntos en una sola línea de tiempo. 1.1. Por qué los equipos la usan - Una sola pantalla para todo. Cuando un cliente llama, el agente ya ve quién es y de qué han hablado antes, sin necesidad de pedirle que se repita. - Sin teléfonos que administrar. Los agentes hablan a través de su navegador usando auriculares o el micrófono y altavoces de la computadora. No hay gastos adicionales de nuevos programas o extensiones de navegador. - Cada llamada queda registrada. Cada llamada se convierte automáticamente en un mensaje en la conversación, mostrando si fue respondida, cuánto duró, quién la atendió, y, cuando está disponible, una grabación que puedes reproducir y una transcripción escrita que puedes leer. - El equipo comparte la carga. Una llamada entrante hace sonar a los agentes disponibles adecuados al mismo tiempo, para que los clientes lleguen rápidamente a una persona real. 1.2. Diferentes formas de recibir una llamada Chatwoot soporta voz a través de dos proveedores. Puedes usar uno o ambos: | Proveedor | Mejor para | Cómo el cliente te contacta | | --------------------- | ---------------------------------- | ------------------------------------------------------------- | | Twilio Voice | Una línea telefónica empresarial | El cliente marca tu número desde cualquier teléfono | | WhatsApp Calling | Empresas ya en WhatsApp | El cliente pulsa "llamar" en tu empresa dentro de WhatsApp | Nota: La llamada de voz es una función premium. Debe estar habilitada en tu cuenta (la función Voice Channel) antes de que aparezcan las siguientes opciones. Si no ves los ajustes de voz, contacta con tu administrador de cuenta o con tu proveedor de Chatwoot. 2. Conectando un canal de voz Configurar la voz es una tarea de administración, realizada una vez por bandeja de entrada. Elige la sección que corresponda al proveedor que deseas. 2.1. Twilio Voice (una línea telefónica) Por favor, sigue este artículo para configurar Twilio Voice: Connecting Twilio voice channel 2.2. Llamadas de WhatsApp Por favor, sigue este artículo para configurar las llamadas de WhatsApp: Connecting WhatsApp voice channel Un requisito para los agentes: su navegador debe tener el permiso de micrófono otorgado para Chatwoot. 3. Uso diario de llamadas de voz Una vez que una bandeja de entrada tiene habilitada la voz, las llamadas funcionan igual para los agentes sin importar el proveedor que esté detrás. 3.1. Recibir una llamada entrante Cuando un cliente llama, un widget flotante de llamada aparece en la esquina de la pantalla para los agentes que deben responder, y suena un timbre. La tarjeta muestra el nombre del llamante, su número y (cuando se conoce) su ubicación, además de por qué canal entró la llamada. Desde ese widget un agente puede: - Unirse a la llamada: responder y comenzar a hablar haciendo clic en el botón verde de aceptar llamada. - Rechazar: rechazar la llamada (el cliente ya no está llamando a este agente) haciendo clic en el botón rojo de rechazar llamada. - Descartar: ocultar silenciosamente el popup en esta pantalla sin rechazar la llamada, para que otros agentes aún puedan atenderla. Puedes hacer esto haciendo clic en el botón de cruz en la parte superior derecha del widget. Si un compañero (o el mismo agente en otra pestaña del navegador) ya ha atendido la llamada, el widget muestra "Siendo atendida en otra pestaña" para que dos personas no respondan la misma llamada. Mientras está conectada, el widget muestra un temporizador en tiempo real y estos controles: - Silenciar micrófono / Activar micrófono: apagar o encender el micrófono del agente haciendo clic en el botón verde del micrófono. - Terminar llamada: colgar haciendo clic en el botón rojo de finalizar llamada. - Ir al hilo de la conversación / Ver historial del chat: ir a la conversación completa sin colgar haciendo clic en el enlace "Ir al hilo de la conversación" en la parte inferior del widget. Esto facilita que el agente pueda ver el historial previo de la conversación u obtener más detalles del contacto. 3.2. Notificación y asignaciones de llamadas Chatwoot contacta a las personas más propensas a ayudar, no hace sonar a todos sin distinción. Para una llamada entrante, llama en este orden de prioridad: 1. El agente asignado, si la conversación ya tiene uno, solo ese agente recibe la llamada. 2. Si no, los agentes en línea de esa bandeja de entrada, todos los disponibles reciben la notificación de llamada al mismo tiempo. 3. Si no, todos los administradores en línea en la cuenta, como último recurso para que ninguna llamada quede sin contestar. Unas reglas que se desprenden de esto: - Solo los agentes disponibles (en línea) ven el popup de llamada para llamadas entrantes. Los agentes que están desconectados u ocupados son omitidos. - El primero que responde gana. No hay cola ni turnos; quien atiende primero toma la llamada, y para los demás deja de sonar y la notificación desaparece. - La llamada se asigna automáticamente a quien la atiende. La conversación pasa a ser de esa persona, así que el seguimiento queda con quien la gestionó. - Las llamadas salientes siempre pertenecen al agente que las inicia. 3.3. Estados de la llamada (qué significan las etiquetas) Cada llamada pasa por un ciclo simple, y la conversación lo refleja: | Lo que ves | Significado | | ----------------------------------------- | ----------------------------------------- | | Llamada entrante / Llamada saliente | La llamada está sonando | | Llamada en curso | Conectado y conversando | | Llamada finalizada | Terminada normalmente | | Sin respuesta (El contacto no contestó) | Llamada saliente que el cliente no atendió | | Llamada perdida (Ningún agente contestó) | Llamada entrante que nadie respondió | | Rechazada por {agente} | Un agente rechazó la llamada | 3.4. Después de la llamada Cuando una llamada termina, se guarda como una entrada de llamada en la línea de tiempo de la conversación, así que queda un registro permanente. Dependiendo de la configuración, esa entrada puede incluir: - Resumen de la llamada: Dirección (entrante/saliente), el estado final, cuánto duró y qué agente respondió (ej. "Tú respondiste", "{agente} respondió" o "Ellos respondieron"). - Grabación: Para llamadas de Twilio se graba y adjunta automáticamente una grabación para que puedas reproducirla. Para llamadas de WhatsApp se adjunta una grabación cuando está disponible. - Transcripción: Si tu cuenta tiene habilitada la transcripción por IA (la integración Captain, sujeta al cupo disponible), la grabación se convierte en texto legible directamente en la entrada de llamada, con una palanca Mostrar más / Mostrar menos para llamadas largas. Una llamada perdida o rechazada también deja una entrada (por ejemplo: Llamada perdida - Ningún agente contestó), y el agente puede usar Devolver llamada desde la conversación para devolver la llamada. 3.5 Iniciar una llamada saliente Cuando un agente pierde una llamada, Chatwoot ofrece la capacidad de devolver la llamada al cliente directamente desde el panel. Dentro de una conversación, el agente puede usar el botón de llamada en el encabezado de la conversación: También puedes iniciar una llamada desde la pantalla de información de contacto. Solución rápida de problemas - No aparecen configuraciones de voz. La función Voice Channel no está habilitada en tu cuenta — pide ayuda a tu administrador o proveedor de Chatwoot. - No se activa la llamada de WhatsApp. El número aún no está inscrito en la API de WhatsApp Business Calling, o la bandeja de entrada no es una de WhatsApp Cloud. Integra el número con Meta / tu proveedor y vuelve a intentarlo. - La llamada conecta pero no hay sonido, o no inicia. Verifica que el navegador tenga permiso de micrófono para Chatwoot, y que está seleccionado un auricular/micrófono. - Un cliente dice que no puede llamar a tu número de WhatsApp. Puede que aún no haya aceptado la solicitud de permiso de llamada — la recibirá cuando un agente intente llamar, y las llamadas funcionarán una vez la acepte.
Conectando el canal de voz de Twilio
Con Twilio Voice, los clientes llaman a un número de teléfono real y los agentes responden en su navegador. Lo que necesitarás de tu cuenta de Twilio: - Account SID y Auth Token - Un API Key SID y API Key Secret (tokens seguros para conectar a cada agente con la llamada) - Una TwiML App y un número de teléfono de Twilio Pasos para crear un nuevo buzón de Voz 1. En Chatwoot, crea (o abre) el buzón "Voice Channel" — Configuración → Bandejas de entrada → Agregar bandeja de entrada → Voz. 2. Ingresa tu número de teléfono de Twilio y las credenciales mencionadas, ingresa tu "API Key SID" y "API Key Secret", luego guarda. 3. Chatwoot te mostrará entonces dos URLs: - Twilio Voice URL - Twilio Status Callback URL 4. Copia estas URLs y actualízalas en el panel de Twilio: pega la "Twilio Voice URL" tanto en la configuración de tu número de teléfono de Twilio como en tu TwiML App, y pega la "Twilio Status Callback URL" en el campo de callback de estado de tu número de teléfono. Pasos para habilitar Voz en buzones existentes 1. Ve a la página de configuración de tu bandeja de entrada. (Configuración > Bandejas de entrada > {Nombre de la bandeja}) 2. Abre la pestaña de configuración "Voz" de la bandeja y activa el botón de opción etiquetado como "Habilitar llamadas de voz". 3. Chatwoot te mostrará entonces dos URLs: - Twilio Voice URL - Twilio Status Callback URL 4. Copia estas URLs y actualízalas en el panel de Twilio: pega la "Twilio Voice URL" tanto en la configuración de tu número de teléfono de Twilio como en tu TwiML App, y pega la "Twilio Status Callback URL" en el campo de callback de estado de tu número de teléfono. 5. Una vez guardado, la bandeja está lista para realizar y recibir llamadas en ese número.
Conectando el canal de voz de WhatsApp
Con las llamadas de WhatsApp, los clientes llaman al número de tu empresa directamente desde la app de WhatsApp, y los agentes responden desde su navegador. Antes de empezar: - La bandeja de entrada debe ser una bandeja de entrada de WhatsApp Cloud (la API oficial de WhatsApp Cloud). Las bandejas de entrada de WhatsApp conectadas a través de otros proveedores (como 360dialog) no pueden utilizar llamadas. - El número de teléfono debe estar inscrito en la API de WhatsApp Business Calling. Si no lo está, activar las llamadas fallará con un mensaje que te pedirá inscribir el número con Meta (o tu proveedor de soluciones de WhatsApp Business) primero. Pasos para habilitar en nuevas bandejas de entrada: 1. En Chatwoot, crea la bandeja de entrada "WhatsApp Call Channel" — Ajustes → Bandejas de entrada → Añadir bandeja de entrada → WhatsApp Call. 2. Realiza el registro integrado para completar la integración de llamadas de voz, una vez finalizado la bandeja de entrada estará lista para realizar y recibir llamadas en ese número. Pasos para habilitar en bandejas de entrada existentes: 1. Abre la pestaña de ajustes "Llamadas" de la bandeja de entrada y activa "Habilitar llamadas de voz". 2. Si la bandeja de entrada está conectada mediante registro integrado: activa la opción de llamada de voz. Si la bandeja está conectada mediante claves manuales, asegúrate de habilitar la suscripción al webhook de llamadas en developers.facebook.com. Cosas a tener en cuenta sobre permisos/consentimiento WhatsApp requiere que el cliente permita recibir llamadas entrantes. Si un agente intenta llamar a alguien que aún no ha dado su consentimiento, Chatwoot envía una solicitud de permiso en lugar de realizar la llamada. Esta solicitud muestra "Se envió una solicitud de permiso de llamada al contacto. Inténtalo de nuevo una vez que acepte." Una vez que el contacto acepta, las llamadas se realizan normalmente. (Si una solicitud fue enviada muy recientemente, Chatwoot espera antes de enviar otra solicitud de llamada). El mensaje de solicitud de permiso de llamada se puede actualizar para enviar un mensaje personalizado al usuario y está disponible en la pestaña Llamadas bajo los ajustes de la bandeja de entrada.