Saltar a la navegación

Freshsales

Busca y añade contactos de Freshsales, y registra notas y tareas de seguimiento durante las llamadas.

Tu recepcionista puede reconocer a quienes llaman y ya están en Freshsales, añadir a nuevos interlocutores como contactos, anotar lo que quería cada persona y crear una tarea de seguimiento para tu equipo. Hay dos formas de conectarlo:

  • Herramientas webhook llaman directamente a la API de Freshsales, sin necesidad de una cuenta de Zapier ni de usar tareas de Zapier. La API de Freshsales busca contactos por nombre o dirección de correo electrónico, no por número de teléfono, por lo que tu recepcionista encuentra a quienes llaman mediante su dirección de correo electrónico.
  • Zapier también puede encontrar a quienes llaman por número de teléfono, pero cada acción consume tareas de tu plan de Zapier.

Usa herramientas webhook a menos que necesites reconocer a quienes llaman por número de teléfono.

Opción 1: Herramientas webhook (recomendado)

1

Obtén tu clave de API y alias de paquete

En Freshsales, selecciona tu foto de perfil, abre Profile Settings y ve a la pestaña API Settings. Copia Your API key y el alias de paquete que aparece debajo, con un aspecto similar a yourcompany.myfreshworks.com/crm/sales. En las URL siguientes, sustituye BUNDLE_ALIAS por este valor, sin https://.

La clave actúa como tu usuario y puede hacer todo lo que puedes hacer tú en Freshsales. Considera crearla desde un usuario cuyo rol solo permita trabajar con contactos, notas y tareas.

2

Busca los ID que debes fijar

Los contactos y las tareas nuevos necesitan el ID del usuario que los posee, y también puedes fijar la fuente del lead y la etapa del ciclo de vida de los contactos nuevos. Ejecuta estos comandos en una terminal, sustituyendo YOUR_API_KEY y BUNDLE_ALIAS, y anota el id de cada valor que quieras:

curl -H "Authorization: Token token=YOUR_API_KEY" https://BUNDLE_ALIAS/api/selector/owners
curl -H "Authorization: Token token=YOUR_API_KEY" https://BUNDLE_ALIAS/api/selector/lead_sources
curl -H "Authorization: Token token=YOUR_API_KEY" https://BUNDLE_ALIAS/api/selector/lifecycle_stages
3

Crea las herramientas webhook

Para cada herramienta de abajo, ve a Integrations, selecciona Add integration y elige Webhook Tool. Todas las herramientas envían la misma cabecera: Authorization (Secret), configurada como Token token= seguido de tu clave de API.

Busca a quien llama

CampoValor
Nombrefind_freshsales_contact
Descripción”Busca a quien llama en nuestro CRM mediante su dirección de correo electrónico. Úsala antes de añadir un contacto nuevo. Pasa el id del contacto a las herramientas de notas y tareas.”
MétodoGET
URLhttps://BUNDLE_ALIAS/api/lookup
Cabeceras de solicitudAuthorization (Secret): Token token= seguido de tu clave de API
Parámetros de consultaq (string, obligatorio): “La dirección de correo electrónico de quien llama, exactamente como la deletrea.”
f (string, valor fijo): email
entities (string, valor fijo): contact
Asignar a agentesReceptionist

Freshsales solo devuelve coincidencias exactas, por lo que el recepcionista debe confirmar con quien llama cómo se escribe su dirección de correo electrónico.

Añade a quien llama

CampoValor
Nombrecreate_freshsales_contact
Descripción”Añade a quien llama como contacto, solo si find_freshsales_contact no lo encontró.”
MétodoPOST
URLhttps://BUNDLE_ALIAS/api/contacts
Cabeceras de solicitudAuthorization (Secret): Token token= seguido de tu clave de API
Parámetros del cuerpocontact (object, obligatorio), con los campos siguientes
Asignar a agentesReceptionist

Selecciona Add field en contact para cada uno de estos campos:

  • first_name (string, obligatorio, de la conversación): “El nombre de quien llama.”
  • last_name (string, de la conversación): “El apellido de quien llama, si lo ha proporcionado.”
  • mobile_number (string, obligatorio, de la conversación): “El número de teléfono de quien llama en formato internacional, por ejemplo +14155550123.”
  • emails (array, de la conversación): “Exactamente un elemento, para la dirección de correo electrónico de quien llama. Omítelo si no ha dado ninguna.” En Each item, elige object y añade dos campos:
    • value (string, obligatorio, de la conversación): “La dirección de correo electrónico de quien llama.”
    • is_primary (boolean, valor fijo): true
  • owner_id (integer, valor fijo): el ID del propietario
  • lead_source_id (integer, valor fijo): el ID de la fuente del lead, si quieres indicar una
  • lifecycle_stage_id (integer, valor fijo): el ID de la etapa del ciclo de vida, si quieres indicar una

Registra una nota

CampoValor
Nombreadd_freshsales_note
Descripción”Anota en el contacto lo que quería quien llama, antes de que termine la llamada.”
MétodoPOST
URLhttps://BUNDLE_ALIAS/api/notes
Cabeceras de solicitudAuthorization (Secret): Token token= seguido de tu clave de API
Parámetros del cuerponote (object, obligatorio), con los campos siguientes
Asignar a agentesReceptionist

Selecciona Add field en note para cada uno de estos campos:

  • description (string, obligatorio, de la conversación): “Lo que quería quien llama, en unas pocas frases.”
  • targetable_type (string, valor fijo): Contact
  • targetable_id (integer, obligatorio, de la conversación): “El id del contacto de find_freshsales_contact o create_freshsales_contact.”

Crea una tarea de seguimiento

CampoValor
Nombrecreate_freshsales_task
Descripción”Crea una tarea de seguimiento para el equipo siempre que prometas devolver la llamada a quien llama.”
MétodoPOST
URLhttps://BUNDLE_ALIAS/api/tasks
Cabeceras de solicitudAuthorization (Secret): Token token= seguido de tu clave de API
Parámetros del cuerpotask (object, obligatorio), con los campos siguientes
Asignar a agentesReceptionist

Selecciona Add field en task para cada uno de estos campos:

  • title (string, obligatorio, de la conversación): “Por ejemplo: Llamar de nuevo a Jane Doe por un presupuesto.”
  • description (string, de la conversación): “El nombre, número de teléfono y necesidades de quien llama.”
  • due_date (string, obligatorio, de la conversación): “Cuándo debe devolver la llamada el equipo, como fecha y hora ISO 8601; por ejemplo, 2026-06-21T11:00:00Z.”
  • owner_id (integer, valor fijo): el ID del usuario que gestiona las devoluciones de llamada
  • targetable_type (string, valor fijo): Contact
  • targetable_id (integer, obligatorio, de la conversación): “El id del contacto de find_freshsales_contact o create_freshsales_contact.”

El propietario y los tipos de registro son valores fijos, por lo que los contactos y tareas nuevos siempre se asignan a las personas que has elegido, aunque la IA envíe otros valores.

find_freshsales_contact devuelve todo lo que está guardado en el contacto. Añade una regla que indique a tu recepcionista que nunca debe repetir a quien llama los datos de un contacto y que debe usarlos solo para reconocerle.

Selecciona Enable en cada herramienta y, a continuación, prueba tu recepcionista como si fueras una persona nueva que llama, proporciona su dirección de correo electrónico y solicita que le devuelvan la llamada. El contacto, una nota y una tarea aparecerán en Freshsales.

Opción 2: Zapier

1

Conecta Zapier

Si aún no lo has hecho, conecta Zapier en Reception.ai.

2

Añade las acciones de Freshsales

En tu servidor MCP de Zapier en mcp.zapier.com, añade las acciones de abajo de la aplicación Freshsales Suite y conecta tu cuenta de Freshsales. Para cada campo, configura un valor fijo o deja que la IA lo rellene, como se indica.

3

Asigna las herramientas

En Reception.ai, abre la pestaña Tools de la integración de Zapier, selecciona Refresh tools y asigna cada acción como se indica.

4

Pruébalo

Prueba tu recepcionista como si fueras una persona nueva que llama y solicita que le devuelvan la llamada. El contacto, una nota y una tarea aparecerán en Freshsales.

Acciones de Zapier

Busca a quien llama

CampoValor
Acción de ZapierFind Contact by Unique Fields
Configurar en ZapierEl campo por el que buscar: el número de teléfono.
Dejar que la IA relleneEl valor que buscar: el número de teléfono de quien llama.
Asignar aClient

Añade a quien llama

CampoValor
Acción de ZapierCreate Contact
Configurar en ZapierEl propietario de ventas, la fuente del lead, la etapa del ciclo de vida y las etiquetas.
Dejar que la IA relleneNombre, apellido, número de móvil y dirección de correo electrónico.
Asignar aClient

Registra una nota

CampoValor
Acción de ZapierAdd Note
Configurar en ZapierEl módulo: Contact.
Dejar que la IA relleneEl ID del contacto (de las acciones anteriores) y el texto de la nota.
Asignar aClient

Crea una tarea de seguimiento

CampoValor
Acción de ZapierCreate Task
Configurar en ZapierEl módulo (Contact) y el propietario que gestiona las devoluciones de llamada.
Dejar que la IA relleneEl título, la fecha de vencimiento, la descripción y el ID del contacto.
Asignar aClient

Independientemente de la opción que uses, añade un procedimiento para que tu recepcionista busque primero a quien llama y solo cree un contacto cuando no se encuentre ninguna coincidencia.

Limitaciones

  • Freshsales no permite dos contactos con el mismo número de móvil o dirección de correo electrónico, por lo que crear un contacto falla si quien llama ya está guardado. Tu recepcionista debe buscar primero.
  • Con herramientas webhook, tu recepcionista encuentra a quienes llaman solo por dirección de correo electrónico. Para encontrarlos por número de teléfono, usa Find Contact by Unique Fields de Zapier.
  • La aplicación Freshsales de Zapier no puede comprobar la disponibilidad de nadie, por lo que tu recepcionista no puede reservar reuniones de forma segura en Freshsales. Usa la tarea de seguimiento o el sistema de reservas de Reception con Google Calendar.
  • Con Zapier, cada acción que ejecuta tu recepcionista consume tareas de tu plan de Zapier. Actualmente, Zapier contabiliza dos tareas por cada llamada realizada correctamente; las llamadas fallidas no cuentan. Cuando se agota el plan, las acciones se detienen hasta que se restablece.

Solución de problemas

ProblemaQué comprobar
401 de FreshsalesLa cabecera Authorization debe ser Token token= seguida de tu clave de API, sin Bearer.
404 de FreshsalesComprueba que cada URL empiece por https://, seguido de tu alias de paquete y, después, /api/.
Una acción de Freshsales no aparece en Reception.aiSelecciona Refresh tools en la integración de Zapier después de añadir acciones en Zapier.
Una acción muestra Changed y no se utilizaLa has editado en Zapier. Selecciona Update en la pestaña Tools.
No se encuentra a personas conocidasCon herramientas webhook, la dirección de correo electrónico debe coincidir exactamente. Con Zapier, Freshsales compara los números de teléfono tal como están guardados, así que guarda los números en un solo formato o busca también por correo electrónico.
No se puede crear un contactoEs posible que quien llama ya esté guardado con ese número de móvil o correo electrónico. Búscalo primero.
No se puede crear una tareadue_date debe ser una fecha y hora que Freshsales acepte. Si se rechaza un valor ISO 8601 como 2026-06-21T11:00:00Z, describe en su lugar el formato del ejemplo de Freshsales, como Tue Jun 21 2026 11:00:00 GMT+0000.
Las notas o tareas no están vinculadas a quien llamaTu recepcionista necesita el ID del contacto de la herramienta de búsqueda o creación, o de Find Contact by Unique Fields o Create Contact en Zapier.