Usa ThunderPhone con Zapier

Conecta la aplicación de ThunderPhone en Zapier a tu organización y crea un Zap que se ejecute cada vez que termine una llamada.

Zapier conecta aplicaciones con flujos de trabajo automatizados llamados Zaps. La aplicación de ThunderPhone en Zapier agrega:

• Desencadenadores: Llamada completada se activa cuando finaliza una llamada telefónica, web o de prueba. Llamada calificada se activa cuando está disponible la calificación de una llamada completada.
• Acciones: Realizar llamada saliente, Agregar contactos a campaña e Iniciar campaña.
• Búsqueda: Buscar llamada busca una llamada por ID y la devuelve con su transcripción y una URL de grabación firmada cuando está disponible.

Encuéntrala en ThunderPhone en Zapier. Para obtener una descripción general de las dos formas de usar Zapier con ThunderPhone, consulta la página de integración con Zapier.

Conecta tu organización#

La aplicación se conecta mediante OAuth. Inicias sesión en ThunderPhone y apruebas el acceso para una organización, sin copiar ninguna clave de API en Zapier.

1. Agrega un paso de ThunderPhone

   En el editor de Zap, busca ThunderPhone (se muestra con una etiqueta Beta) y elige un desencadenador o una acción. Cuando Zapier solicite una cuenta, conecta una nueva. Zapier abre una ventana de inicio de sesión de ThunderPhone.

2. Inicia sesión y elige la organización

   Inicia sesión, revisa los permisos solicitados, elige la organización y selecciona Aprobar. La aplicación solicita permiso para leer tus agentes y números de teléfono, leer y escribir llamadas y campañas, administrar integraciones como puntos de conexión de webhook y ver el correo electrónico de tu cuenta.

3. Revisa el nombre de la conexión

   Zapier nombra la conexión según la organización que aprobaste, para que puedas distinguir las conexiones cuando perteneces a más de una.

Conéctate con una cuenta que tenga el rol de administrador o propietario en esa organización. Activar o desactivar un Zap de desencadenador, y cada acción, requiere ese rol. Un Zap de desencadenador que ya está activado sigue recibiendo eventos de llamadas después de que cambie el rol o se revoque la conexión. Desactívalo para detenerlos. Buscar llamada funciona para cualquier miembro.

La aplicación no tiene un cargo propio de ThunderPhone. Las llamadas que realiza o inicia se facturan según tus tarifas normales de ThunderPhone, y Zapier cuenta las tareas de tu plan de Zapier.

Crea un primer Zap#

Este Zap agrega una fila a una hoja de Google Sheets cada vez que finaliza una llamada.

1. Haz una llamada para usarla como datos de muestra

   Abre un agente en el constructor, haz clic en Hablar y finaliza la llamada. Las llamadas de prueba del constructor activan Llamada completada, por lo que esto proporciona al activador una llamada reciente para cargar.

2. Agrega el activador

   Elige ThunderPhone como la app del activador, establece el evento en Llamada completada y selecciona tu conexión de ThunderPhone. Prueba el activador. Zapier carga tus llamadas completadas más recientes como muestras, con la misma estructura que un evento en tiempo real.

3. Agrega Google Sheets

   Agrega una acción de Google Sheets que cree una fila de hoja de cálculo. Elige una hoja con una fila de encabezados y, luego, asigna cada columna a un campo del activador (consulta la tabla a continuación).

4. Publica el Zap

   Publica y activa el Zap. Al activarlo, se crea un endpoint de webhook en tu organización de ThunderPhone llamado Zapier: Llamada completada. Al desactivar el Zap, se elimina ese endpoint.

5. Pruébalo

   Haz otra llamada de prueba en el constructor. Cuando finalice, se ejecutará el Zap y aparecerá una fila.

Columnas útiles:

El enlace de llamada abre la llamada en el panel de ThunderPhone para los miembros de tu organización, con su transcripción y grabación, por lo que la hoja no necesita almacenar ninguna de las dos.

El evento también puede incluir la transcripción, como una lista de intervenciones, y una URL de grabación, un enlace firmado que vence. Agrégalos solo si la hoja los necesita. Las transcripciones, resúmenes y grabaciones de llamadas pueden contener información personal o de salud. Envíalos solo a apps que tu organización tenga permitido usar para esos datos, conforme a un BAA cuando haya información de salud involucrada, y conserva solo los campos que necesites. Consulta telephony.complete / web.complete para ver todos los campos.

Desencadenantes, acciones y búsqueda#

Llamada calificada proporciona el ID de llamada, el ID de agente, el nombre del agente y la calificación: ID de calificación, puntaje, resultado de la llamada, resumen, modelo de calificación y fecha de calificación. Al activar un Zap, se crea un punto de conexión llamado Zapier: Llamada calificada. Una llamada puede calificarse más de una vez, y cada ejecución de calificación finalizada activa el desencadenante. Consulta call.graded.

Buscar llamada recibe un ID de llamada, con un menú desplegable de llamadas recientes. Devuelve el agente de la llamada, la dirección, los números, las horas de inicio y finalización, el estado, el motivo de finalización, el puntaje de calificación y el resultado de la llamada, la transcripción y una URL de grabación firmada cuando está disponible. Un ID de llamada desconocido no devuelve ningún resultado en lugar de un error.

Realizar llamada saliente recibe:

Devuelve el ID de llamada, el estado y la repetición idempotente.

Agregar contactos a campaña agrega contactos a una campaña en borrador. Para un contacto, completa Número de teléfono en formato E.164 y, opcionalmente, Variables de contacto, un objeto JSON cuyas propiedades se convierten en variables de campaña. Para un lote, completa JSON de contactos con una matriz de hasta 5,000 objetos. Cada uno necesita phone_number, y sus demás propiedades se convierten en variables. El paso falla cuando se rechazan todos los contactos y establece Éxito parcial cuando solo se rechazan algunos.

Iniciar campaña inicia o reanuda una campaña que tiene al menos un contacto. Requiere Consentimiento para cobrar. Consulta Campañas salientes.

Antes de que un Zap realice llamadas#

Realizar llamada saliente e Iniciar campaña marcan números de teléfono reales e inician llamadas facturables.

• Si ThunderPhone le pide a tu organización que confirme que sus llamadas salientes cumplen con la TCPA y otras leyes de llamadas, un administrador debe registrar esa confirmación en el panel antes de que un Zap pueda iniciar llamadas.
• El número de origen debe estar habilitado para llamadas salientes. Los números que traigas de tu propio operador cumplen los requisitos una vez verificados. Los números proporcionados por ThunderPhone comienzan solo para llamadas entrantes, y puedes solicitar acceso a llamadas salientes para ellos en el panel. Consulta Obtener un número de teléfono.
• Realizar llamada saliente requiere una Clave de idempotencia. Asigna un ID estable del desencadenante o registro de origen, como el ID de evento de ThunderPhone o un ID de registro de CRM. Si Zapier vuelve a intentar el paso, ThunderPhone reconoce la clave y devuelve la llamada original en lugar de realizar una segunda. Evita marcas de tiempo, valores aleatorios o solo el ID del Zap.
• Iniciar campaña requiere Consentimiento para cobrar, que confirma que el Zap puede iniciar llamadas salientes facturables en tu cuenta.
• Tu organización es responsable de contar con el consentimiento para llamar a cada número y de cumplir con las leyes de llamadas aplicables. Consulta leyes de llamadas salientes.

Una clave de idempotencia es única en toda tu organización y puede tener un máximo de 128 caracteres. Reutilizar una clave con un agente, número o variables diferentes da error de conflicto, así que si dos Zaps pueden llamar sobre el mismo registro, asigna a cada Zap su propio prefijo fijo antes del ID de registro. Realizar llamadas salientes explica la API detrás de esta acción.

Ejemplos de Zaps#

• Llamada completada a un CRM. Registra una actividad por cada llamada finalizada con su estado, motivo de finalización y transcripción.
• Llamada evaluada para seguimiento. Filtra según el resultado o la puntuación de la llamada y dirige la llamada al flujo de trabajo de seguimiento adecuado.
• Nuevo lead para una campaña. Agrega el lead a una campaña en borrador con Agregar contactos a la campaña y, luego, ejecuta Iniciar campaña cuando alguien apruebe la lista.

Las transcripciones, los resúmenes y las grabaciones de llamadas pueden contener información personal o de salud. Envíalos solo a aplicaciones que tu organización tenga autorización para usar con esos datos, conforme a un BAA cuando haya información de salud involucrada, y conserva solo los campos que necesites.

Solución de problemas#

Un paso falla con un error de autorización. Vuelve a conectar la conexión de ThunderPhone en Zapier y aprueba de nuevo. Una conexión deja de funcionar cuando la persona que la conectó la revoca en ThunderPhone en Organización → Claves → Aplicaciones autorizadas, cuando esa persona deja la organización o cuando pasan 30 días sin una actualización exitosa del token. Consulta Conectar con OAuth.

No se puede activar o desactivar un Zap, o se rechaza una acción. La persona que lo conectó necesita el rol de administrador o propietario en la organización. Vuelve a conectar con una cuenta que lo tenga. Un Zap activador que ya está activo sigue recibiendo eventos de llamadas después de que cambie el rol o se revoque la conexión. Desactívalo para detenerlos.

Quieres desconectar la aplicación. Desactiva tus Zaps de ThunderPhone antes de revocar la conexión, ya que desactivar un Zap elimina su endpoint y requiere una conexión funcional. Si revocaste primero, elimina el endpoint restante Zapier: … con DELETE /v1/developer/webhook-endpoints/{id} mediante una clave API de administrador. Consulta Endpoints de webhook.

El Zap debe usar una organización diferente. Cada conexión abarca una organización. Primero desactiva el Zap para que su endpoint de webhook se elimine de la organización actual. Luego conecta una nueva cuenta de ThunderPhone en Zapier, elige la otra organización cuando apruebes y selecciona esa conexión en cada paso de ThunderPhone. Los agentes, números y campañas son diferentes entre organizaciones, así que selecciona Agente, Número de origen y Campaña de nuevo en cada paso que los incluya. Luego vuelve a activar el Zap.

El activador dejó de ejecutarse. Cada Zap con un activador de ThunderPhone tiene un endpoint de webhook en tu organización, llamado Zapier: Llamada completada o Zapier: Llamada evaluada. Se crea cuando se activa el Zap y se elimina cuando se desactiva. Déjalo tal como está. Si se editó o eliminó en ThunderPhone, desactiva y vuelve a activar el Zap para crear uno nuevo. Con una clave API de administrador, GET /v1/developer/webhook-deliveries muestra intentos de entrega recientes.