El flujo de trabajo del CRM a la IA de voz, explicado sin tecnicismos

Conectar un CRM a un agente de voz con IA se reduce a cuatro traspasos. El CRM decide a quién se llama. La solicitud de llamada lleva lo que el agente necesita saber. El agente mantiene la conversación. Los resultados vuelven al mismo registro del CRM. La mayor parte de la confusión con las integraciones viene de mezclar estos cuatro pasos o de no saber qué sistema se encarga de cada uno.

Esta guía recorre la secuencia usando un flujo de trabajo de HubSpot como ejemplo y, después, muestra el mismo ciclo para cualquier CRM que pueda enviar un webhook.

¿Cuáles son las cuatro fases de un flujo de trabajo del CRM a la IA de voz?

Disparador, contexto, conversación y volcado de resultados:

1. Disparador. Un evento del CRM (un formulario enviado, un cambio de etapa de un negocio, una fecha alcanzada) inicia un flujo de trabajo que pide a la plataforma de voz que realice una llamada.
2. Contexto. La solicitud de llamada lleva datos del registro del CRM, así que el agente empieza la llamada sabiendo ya el nombre y la situación del contacto.
3. Conversación. El agente habla y puede leer o actualizar registros del CRM mientras lo hace.
4. Volcado de resultados. Tras la llamada, se adjuntan al registro del CRM un resumen, campos de resultado estructurados, la transcripción y la grabación, y el flujo de trabajo del CRM decide qué ocurre después.

¿Qué lanza realmente la llamada con IA desde el CRM?

Un flujo de trabajo del CRM lanza la llamada de una de dos maneras: con una acción nativa del flujo de trabajo o con un webhook que tu propio servicio convierte en una llamada a la API.

Acción nativa (HubSpot). La app de Retell AI en el HubSpot Marketplace añade la acción Make a Phone Call a los flujos de trabajo de HubSpot. Parte de un disparador que ya uses: el envío de un formulario, un registro nuevo, un cambio de etapa de un negocio o una propiedad de fecha, como la fecha de una cita. Añade la condición "Phone number is known" para que los contactos sin número nunca se inscriban. Después, rellena tres campos de la acción: From (el agente y el número de teléfono de Retell), To (el token del teléfono del contacto) y, opcionalmente, Dynamic Variables en formato JSON. El flujo de trabajo se detiene hasta que termina la llamada.

Webhook más API (cualquier CRM). Si tu CRM puede enviar un webhook desde un flujo de trabajo, apúntalo a un pequeño servicio propio. Ese servicio llama a la API Create Phone Call de Retell con cuatro elementos: from_number, to_number, los campos de contexto en retell_llm_dynamic_variables y el ID del registro del CRM en metadata. Retell guarda metadata con la llamada y lo devuelve en el objeto de la llamada en los webhooks posteriores, y así es como el resultado llega al registro correcto.

Listas en lugar de eventos. Para una campaña dirigida a un segmento en vez de a un único evento, exporta la lista y ejecútala como llamadas por lotes: un CSV con una columna de número de teléfono, en el que cada columna adicional se convierte en una variable que el agente puede usar.

Hay dos requisitos previos en todos los casos. El número desde el que se llama necesita tener asociado un agente de salida, y los números que marcas deben estar en formato E.164 válido (por ejemplo, +14155550123).

¿Cómo sabe el agente a quién está llamando?

Mediante variables dinámicas: valores con nombre, como {{first_name}} o {{deal_stage}}, que Retell rellena antes de que hable el agente. Proceden de tres fuentes:

• La solicitud de llamada. Todo lo que el JSON de la acción de HubSpot o tu llamada a la API pase en retell_llm_dynamic_variables.
• Campos de contacto sincronizados. Si usas la sincronización nativa de contactos del CRM de Retell, una llamada cuyo número coincida con un contacto sincronizado recibe automáticamente los campos asignados de ese contacto como variables.
• Una consulta previa a la llamada. Una función previa a la llamada en la página Workflow del agente puede buscar el número en el CRM y asignar campos de la respuesta a variables. En las llamadas salientes se ejecuta antes de que Retell marque, así que el contacto nunca oye la consulta.

Cuando el mismo nombre procede de más de una fuente, el valor de la solicitud prevalece sobre el campo del contacto sincronizado, y todo lo que el agente recopile durante la llamada prevalece sobre ambos.

Tres reglas evitan la mayoría de los casos en los que un agente lee en voz alta un marcador de posición:

• Envía cada valor como cadena de texto, es decir, "42" y "true", no 42 y true.
• Aplana los objetos. {{client.name}} no se resolverá; envía client_name en su lugar.
• Define valores predeterminados a nivel de agente. Una variable sin valor se queda en el prompt en su forma original {{braces}}.

¿Qué ocurre durante la llamada?

El agente lleva la conversación a partir de su prompt y sus variables, y puede actuar sobre el CRM en plena llamada si le das herramientas.

Con HubSpot conectado mediante la integración nativa de Retell, el agente puede usar herramientas como Search Contact, List Contact Deals, Update Deal, Update Contact y Create Task mientras habla. Puede corregir una dirección de correo electrónico que el contacto acaba de dar o crear la tarea de seguimiento que el contacto ha aceptado. Para un CRM sin integración nativa, una función personalizada hace el mismo trabajo llamando a tu propia API durante la llamada.

Ten en cuenta dos comportamientos. Si una llamada a una herramienta del CRM falla o agota el tiempo de espera, la conversación continúa, así que el prompt debe indicar al agente qué decir cuando una consulta no devuelve nada. Y cuando una llamada saliente llega al buzón de voz en lugar de a una persona, el agente puede colgar o dejar un mensaje, según cómo lo configures, y la llamada se marca con in_voicemail. Ese indicador es importante en el volcado de resultados.

¿Cómo vuelven los resultados de la llamada al registro del CRM?

Cuando termina la llamada, Retell ejecuta el análisis posterior a la llamada sobre la transcripción (el producto lo llama Post Call Extraction). Después, los resultados llegan al CRM por una de tres vías, según lo que admita tu CRM y quién deba encargarse de la lógica de asignación.

Qué se genera. Cada llamada obtiene call_summary, user_sentiment, call_successful e in_voicemail. Puedes añadir campos personalizados para tus propios resultados, cada uno de tipo booleano, texto, número o selector: qualified, budget_range, callback_requested. El registro de la llamada también incluye la transcripción completa y una URL de la grabación. Consulta el análisis posterior a la llamada para ver cómo se definen los campos.

Vía 1: la app del HubSpot Marketplace. Cuando la llamada termina, la app escribe el resumen y el análisis en la cronología de actividad del contacto, añade la grabación y la transcripción al registro de llamadas y muestra ese registro en la cronología de la empresa asociada. Después, el flujo de trabajo en pausa se reanuda y puede ramificarse según resultados como Call Success, User Sentiment o Call Outcome: un correo de seguimiento si la llamada tiene éxito, un reintento o un SMS si no hay respuesta.

Vía 2: integración nativa con el CRM. Las integraciones de Retell con HubSpot, Salesforce, Microsoft Dynamics 365, GoHighLevel y Zoho CRM asignan los campos del análisis posterior a la llamada a campos del contacto y los envían al registro del CRM. Cada asignación tiene un modo de actualización: Overwrite para campos de estado, Fill only if empty para datos estables como el correo electrónico, o Accumulate & summarize para combinar notas de varias llamadas. Activa Log activities automatically y cada llamada también quedará registrada en el contacto, por ejemplo como Call engagement en HubSpot o como Task en Salesforce. Las funciones posteriores a la llamada añaden escrituras específicas encima, como un Create Task de HubSpot que solo se ejecuta cuando un campo followup_needed es true.

Un matiz de la vía 2: solo escribe en contactos importados desde la conexión activa con el CRM. Un número que no coincide con un contacto sincronizado no genera ningún registro de actividad, y Retell actualiza registros existentes del CRM en lugar de crear otros nuevos, salvo que actives Create new contacts in CRM.

Vía 3: un webhook hacia tu CRM. Retell envía un evento call_analyzed a tu endpoint con el objeto completo de la llamada: transcripción, URL de la grabación, resultados del análisis y el metadata que enviaste al lanzarla. Tu servicio lee el ID del registro desde metadata y escribe en la API del CRM. Verifica la cabecera x-retell-signature y devuelve un 2xx en menos de 10 segundos, porque, de lo contrario, Retell reintenta hasta 3 veces. Elimina duplicados por call_id para que un reintento nunca escriba la misma llamada dos veces. Escucha call_analyzed, no call_ended: la carga útil de call_ended se envía antes de que se ejecute el análisis, así que no incluye resultados del análisis.

¿Cómo es la correspondencia completa entre disparador y volcado de resultados?

La tabla relaciona disparadores habituales de HubSpot con lo que hace el agente y lo que vuelve al registro. La vía del webhook sigue las mismas tres columnas.

Los campos de análisis personalizados no se rellenan en las llamadas que nunca llegaron a conectarse, así que construye la rama de "sin respuesta" sobre los campos integrados y el resultado de la llamada, no sobre tus campos personalizados.

¿Qué debes comprobar antes de pasar a producción?

• Cada contacto inscrito tiene un número de teléfono E.164 válido, y el flujo de trabajo filtra el resto.
• Las credenciales del CRM tienen permiso de escritura en todos los objetos en los que vuelcas datos. En HubSpot, si falta un scope la conexión no muestra ningún aviso; simplemente deja de funcionar la escritura afectada.
• Cada campo de análisis personalizado tiene una descripción concreta para que el LLM extraiga la información, y existe una propiedad del CRM equivalente.
• Las escrituras posteriores a la llamada están condicionadas, de modo que una llamada que nunca se conectó no escribe nada engañoso.
• Un único sistema se encarga de la entrada en la cronología. La app del Marketplace y la integración nativa son independientes y pueden funcionar a la vez, así que decide cuál registra la llamada.
• La lista de no llamar se aplica donde esperas. El campo de contacto do_not_call de Retell no bloquea llamadas por sí solo; pasa honor_internal_dnc: true en las llamadas a la API para que Retell las rechace, y mantén las reglas de exclusión propias de tu CRM en el disparador.
• Haces las pruebas con un registro de sandbox. Probar una herramienta de creación o actualización escribe un registro real.

Por dónde empezar

Si HubSpot es tu sistema de referencia, la integración de Retell con HubSpot cubre las dos mitades de este ciclo: la conexión nativa que da contexto al agente y vuelca los resultados, y la app del Marketplace que permite a un flujo de trabajo de HubSpot realizar la llamada. Para la configuración paso a paso, incluidos los scopes de la app privada, sigue la guía de configuración de HubSpot. ¿Usas Salesforce, Dynamics 365, Zoho u otro sistema? Empieza por el directorio de integraciones y usa la vía del webhook para cualquier CRM que no aparezca.

Lecturas relacionadas: La lista de comprobación de números de teléfono salientes, cómo definir el alcance de un primer acuerdo con un partner y más guías en el centro Retell Learn.