--- title: "Usa ThunderPhone con Zapier" description: "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](https://zapier.com) 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](https://zapier.com/apps/thunderphone/integrations). Para obtener una descripción general de las dos formas de usar Zapier con ThunderPhone, consulta la [página de integración con Zapier](https://thunderphone.com/integrations/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. 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. 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. 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. 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. 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. 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). 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. Haz otra llamada de prueba en el constructor. Cuando finalice, se ejecutará el Zap y aparecerá una fila. Columnas útiles: | Columna | Campo de Llamada completada | |---|---| | ID de llamada | ID de llamada | | Agente | Nombre del agente | | Dirección | Dirección | | Desde | Número de origen | | Para | Número de destino | | Inicio | Hora de inicio | | Finalización | Hora de finalización | | Duración (s) | Duración en segundos | | Estado | Estado | | Motivo de finalización | Motivo de finalización | | Enlace de llamada | Escribe `https://app.thunderphone.com/dashboard/call-history/` y luego inserta el ID de llamada | 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`](/es/webhooks/call-complete) para ver todos los campos. Cada entrega está firmada. La app verifica el HMAC de `X-ThunderPhone-Signature` contra el secreto del endpoint antes de que se ejecute el Zap y se detiene ante cualquier entrega sin firma o no válida. Si Zapier no acepta una entrega, ThunderPhone la reintenta durante un máximo de 24 horas. Consulta la [descripción general de webhooks](/es/webhooks/overview). ## 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`](/es/webhooks/events). **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: | Campo | Significado | |---|---| | Agente | Un agente guardado. El menú desplegable muestra tus agentes. | | Número de destino | Destino en formato E.164, como `+14155552671`. | | Número de origen | El menú desplegable muestra solo números habilitados para llamadas salientes. | | Variables | Objeto JSON opcional de valores para marcadores de posición en el prompt del agente. | | Clave de idempotencia | Un ID estable del desencadenante o registro de origen. Obligatorio. | 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](/es/guides/outbound-campaigns). ## 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](/es/guides/get-a-phone-number). - 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](/es/guides/outbound-calling-laws). 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](/es/guides/place-outbound-calls) 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](/es/guides/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](/es/webhooks/endpoints). **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`](/api-reference/webhook-deliveries) muestra intentos de entrega recientes. ¿Quieres que el agente use acciones de Zapier durante una llamada en lugar de después de ella? Conecta un endpoint MCP de Zapier en **Conexiones → MCP**. Consulta [Servidores MCP](/es/guides/mcp-servers). Para enviar los mismos eventos de llamada a tu propio servidor, consulta [Endpoints de webhook](/es/webhooks/endpoints).