AtendyDocumentación Ir al panel

Herramientas e integraciones

Cómo dar superpoderes a tu agente: que consulte y guarde datos durante la llamada con webhooks e integraciones como Cal.com, Google Calendar, email, Slack, WhatsApp y WooCommerce.

Herramientas e integraciones

Una herramienta es una acción que tu agente puede realizar mientras habla por teléfono: consultar un dato, comprobar un hueco en la agenda, guardar una reserva, avisar a tu equipo o crear una cita. Sin herramientas, el agente solo puede conversar con lo que sabe. Con herramientas, actúa: se conecta con tus sistemas en tiempo real, en mitad de la conversación, y sigue hablando con el cliente con la respuesta ya en la mano.

Qué es una herramienta

Por debajo, una herramienta llama a un webhook: una dirección web (URL) de tu negocio o de un servicio externo a la que el agente envía o pide datos durante la llamada. Tú le dices al agente cuándo usarla y qué información necesita, y él decide por su cuenta el momento adecuado dentro de la conversación.

Ejemplo: el cliente dice que quiere reservar mesa para el sábado a las nueve. El agente llama a la herramienta guardar_reserva, envía el día, la hora y el número de personas a tu sistema, recibe la confirmación y le dice al cliente que la mesa ya está apuntada. Todo sin que nadie de tu equipo intervenga.

Las herramientas funcionan igual en las llamadas de teléfono y en la prueba del navegador. Puedes comprobar que todo encaja con Probar agente antes de conectar el agente a un número real.

Cómo configurar una herramienta

  1. Entra en la sección Agentes del panel y edita el agente al que quieras dar la herramienta.
  2. Abre el asistente de herramientas del agente.
  3. Elige el tipo: una integración lista (Cal.com, Google Calendar, email, Slack o WhatsApp) o un webhook personalizado hacia tu propio sistema.
  4. Ponle un nombre claro y una descripción de cuándo debe usarla. Esa descripción es la que lee el agente para decidir el momento, así que sé concreto (por ejemplo: usar solo cuando el cliente confirma día y hora).
  5. Indica los datos que el agente debe enviar o recoger (los parámetros): nombre del cliente, fecha, número de personas, etc.
  6. Añade la URL y las credenciales que haga falta según el tipo de herramienta.
  7. Guarda y prueba el agente con Probar agente en el navegador. Comprueba en la analítica que la herramienta se invoca y devuelve lo esperado antes de conectarlo a un número.

Integraciones disponibles

Además del webhook personalizado hacia tu propio sistema, Atendy incluye integraciones ya preparadas con los servicios más habituales:

Cal.com
Consulta huecos libres y crea citas en tu calendario de Cal.com durante la llamada. Ideal para reservas y agendado automático.
Google Calendar
Agenda eventos y comprueba disponibilidad directamente sobre tu calendario de Google.
Email
El agente envía un correo cuando ocurre algo relevante: un resumen de la llamada, una petición del cliente o un aviso a tu equipo.
Slack
Manda un mensaje a un canal de Slack para avisar en el momento (por ejemplo, un lead caliente o una incidencia).
WhatsApp
Envía mensajes de WhatsApp desde la llamada, por ejemplo una confirmación al cliente. Disponible en el plan Escala.
WooCommerce
Conecta tu tienda online: el agente identifica al cliente que llama, consulta el estado de sus pedidos y la información de productos, y puede enviarle el seguimiento por email. Conexión de solo lectura: informa, nunca modifica la tienda.
Webhook personalizado
Conecta el agente con cualquier sistema tuyo mediante una URL propia: tu CRM, tu base de datos, tu tienda o un flujo de n8n.

Dónde poner las credenciales

Las integraciones que se conectan a un servicio externo necesitan una credencial que autoriza a Atendy a actuar en tu nombre, normalmente una API key. Se introduce dentro del asistente de herramientas del agente, en la integración correspondiente. No hay que tocar código.

Por ejemplo, para conectar Cal.com necesitas su API key. Así se consigue:

  1. Entra en tu cuenta de Cal.com.
  2. Abre Ajustes (Settings) y ve a la sección de desarrollador (Developer o API Keys).
  3. Crea una nueva API key y cópiala.
  4. Vuelve al asistente de herramientas de tu agente en Atendy, elige la integración de Cal.com y pega ahí la clave.
Trata tus API keys como una contraseña. No las compartas por correo ni las publiques en ningún sitio. Se guardan cifradas y solo se usan para las herramientas de tu agente. Si crees que una clave se ha filtrado, bórrala en el servicio de origen (Cal.com, etc.) y genera una nueva.

WooCommerce (tu tienda online)

Si vendes con WooCommerce, Atendy trae una integración nativa: no hace falta programar ni montar un flujo en otra herramienta. Con ella, el agente atiende por teléfono las llamadas más repetidas de una tienda y responde con los datos reales de tu WooCommerce, en tiempo real y siguiendo tu guion.

Identificar a quien llama
Con el teléfono de la llamada, el agente reconoce al cliente y trae su nombre, sus pedidos abiertos y anteriores, su dirección y su email para atenderle sin pedirle que se repita.
Estado del pedido
Localiza el pedido por número, email o teléfono y da su estado y fecha. Si tu tienda guarda el número de seguimiento, también el enlace del transportista.
Información de productos
Consulta el catálogo (precio, disponibilidad y variantes) para resolver dudas de compra. El agente informa y remite al enlace de compra; no cobra por voz.
Enviar seguimiento por email
Si activas la herramienta de email, el agente manda al cliente el estado del pedido y el enlace de seguimiento por correo. Reutiliza la misma integración de email, sin configurar nada dos veces.
La conexión con WooCommerce es de solo lectura: el agente consulta pedidos y productos e informa, pero nunca cambia estados, precios ni stock. Es una decisión de diseño, no un ajuste que puedas desactivar sin querer.

Cómo conectar tu WooCommerce

  1. En tu tienda, entra en WooCommerce → Ajustes → Avanzado → API REST y pulsa Añadir clave.
  2. Ponle una descripción (por ejemplo, Atendy) y elige permiso de Solo lectura. Genera la clave.
  3. Copia la clave de cliente (Consumer key) y el secreto de cliente (Consumer secret); el secreto solo se muestra una vez.
  4. En Atendy, abre el asistente de herramientas del agente y elige la integración de WooCommerce.
  5. Pega la dirección de tu tienda (https://tutienda.com) y las dos claves. Elige qué activar: identificar al cliente, buscar pedidos, información de productos.
  6. Prueba el agente con Probar agente en el navegador antes de conectarlo a un número.
La dirección de la tienda tiene que ser completa y accesible por internet con https (por ejemplo https://tutienda.com, con su dominio entero). Si activas el envío del seguimiento por email pero no has configurado la herramienta de email, el agente no ofrecerá esa opción en la llamada.

Nota: WooCommerce no expone un campo de tiempo estimado de entrega, así que el agente no inventa un plazo. Da el estado y la fecha del pedido y, si tu tienda guarda el seguimiento del transportista, su enlace. Tienes el detalle de cada caso con ejemplos en el artículo del blog «Qué puede resolver un agente de voz conectado a WooCommerce».

Variables y {{numero_origen}}

Las variables son huecos que se rellenan solos con datos de cada llamada. Se escriben entre dobles llaves y puedes usarlas tanto en las herramientas como en el prompt del sistema y en el saludo inicial. La más útil es {{numero_origen}}, que siempre trae el teléfono de quien llama.

VariableQué contiene
{{numero_origen}}El teléfono del llamante. Está disponible siempre en las llamadas y es perfecto para identificar al cliente o guardarlo con la reserva.
{{variable}} del webhook de entradaCualquier dato que devuelva tu webhook de entrada antes de la llamada (nombre del cliente, su último pedido, si es socio, etc.). Ese webhook recibe el número que llama y puede responder con datos que luego usas como {{nombre}}, {{pedido}}, etc.
{{variable}} de campañas y APIEn llamadas salientes por campaña (CSV) o lanzadas por la API, los datos que envías por cada contacto se inyectan como variables. Por ejemplo {{nombre}} para que el agente salude por su nombre.
Si usas una variable que en una llamada concreta no tiene valor, Atendy la elimina para que el agente no lea en voz alta un hueco vacío. Aun así, apóyate en variables que sepas que van a existir, como {{numero_origen}}.

Ejemplo: una herramienta webhook

Así se ve la definición de una herramienta personalizada que guarda una reserva en tu sistema. El agente la llamará cuando el cliente confirme día y hora, y enviará los datos indicados en parametros, incluido el teléfono del llamante con {{numero_origen}}:

{
  "nombre": "guardar_reserva",
  "descripcion": "Guarda una reserva cuando el cliente confirma dia y hora",
  "url": "https://tu-negocio.com/api/reservas",
  "metodo": "POST",
  "cabeceras": {
    "Authorization": "Bearer TU_TOKEN"
  },
  "parametros": {
    "nombre": "Nombre de la persona que llama",
    "fecha": "Dia y hora de la reserva",
    "personas": "Numero de comensales",
    "telefono": "{{numero_origen}}"
  }
}

En cabeceras pones lo que tu sistema necesite para autenticar la petición (por ejemplo un token). En parametros describes con palabras cada dato: el agente entiende esa descripción y rellena los valores a partir de la conversación. El teléfono se completa solo con {{numero_origen}}.

Cada vez que el agente usa una herramienta queda registrado en la analítica de la llamada: qué herramienta llamó y qué respuesta recibió. Así puedes revisar que todo funciona y depurar si algo falla.