Herramientas e integraciones

Cómo conectar tu agente con webhooks, calendarios, email y tiendas online. WhatsApp está disponible actualmente en Enterprise.

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

Entra en la sección Agentes del panel y edita el agente al que quieras dar la herramienta.
Abre el asistente de herramientas del agente.
Elige una integración disponible en tu panel o un webhook personalizado. WhatsApp se configura actualmente con el equipo de Atendy en Enterprise.
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).
Indica los datos que el agente debe enviar o recoger (los parámetros): nombre del cliente, fecha, número de personas, etc.
Añade la URL y las credenciales que haga falta según el tipo de herramienta.
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. Para calcular la disponibilidad se leen los eventos del rango consultado, pero solo se usan sus horas de inicio y fin.

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).

Envía mensajes de WhatsApp desde la llamada mediante plantillas aprobadas por Meta. Disponible actualmente como configuración Enterprise; no forma parte de los planes autoservicio.

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.

PrestaShop

Conecta tu tienda PrestaShop: el agente identifica al cliente que llama, consulta el estado de sus pedidos y la información de productos (precio y disponibilidad). Conexión de solo lectura por el Webservice de PrestaShop: informa, nunca modifica la tienda.

Shopify

Conecta tu tienda Shopify: el agente identifica al cliente que llama, consulta el estado de sus pedidos y la información de productos (precio y disponibilidad). Conexión de solo lectura por la Admin API de Shopify: informa, nunca modifica la tienda.

TheFork (Beta)

Conecta las reservas de tu restaurante en TheFork: el agente reconoce al cliente que llama, consulta las mesas libres y reserva, cambia o anula su reserva.

Docfav (Beta)

Conecta la agenda de tu clínica en Docfav: el agente reconoce al paciente que llama, consulta los tratamientos y las horas libres del gabinete, y reserva, cambia o cancela sus citas.

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.

Datos de Google (Google Calendar): Atendy usa solo los permisos mínimos de cada integración y cumple los requisitos de Uso Limitado (Limited Use) de las APIs de Google. El uso de los datos de Google, su conservación y cómo desconectar la cuenta se explican en el apartado «Datos de Google» de la Política de Privacidad (atendy.es/privacidad).

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:

Entra en tu cuenta de Cal.com.
Abre Ajustes (Settings) y ve a la sección de desarrollador (Developer o API Keys).
Crea una nueva API key y cópiala.
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.

WhatsApp: por qué hace falta una plantilla

WhatsApp no deja escribir libremente a cualquiera. Solo puedes enviar un mensaje de texto normal si esa persona te ha escrito a ti por WhatsApp en las últimas 24 horas. Como tu agente habla por teléfono, esa ventana casi nunca está abierta: por eso el mensaje se envía con una plantilla, que es un texto registrado y aprobado por Meta con huecos que tu agente rellena en cada llamada.

Por ejemplo, una plantilla puede decir «Hola {{nombre}}, te confirmamos tu cita para el {{fecha}}. Si necesitas cambiarla, llámanos.» y el agente pone el nombre y la fecha de esa conversación. El texto lo fijas tú: el agente no lo improvisa. Los huecos también pueden ir numerados en vez de con nombre, según cómo esté hecha tu plantilla en Meta; Atendy los reconoce igual y te deja ponerles nombre para que el agente sepa qué va en cada uno.

En Enterprise, el equipo de Atendy configura WhatsApp con el Phone Number ID, el WABA ID, el token de acceso y una plantilla aprobada por Meta.
El token necesita dos permisos: whatsapp_business_messaging para enviar y whatsapp_business_management para leer y crear plantillas. Si te falta el segundo, Atendy no podrá mostrarte tus plantillas.
En el paso siguiente, Atendy lee las plantillas de tu cuenta y las lista. Elige una de las aprobadas, o crea una nueva ahí mismo.
Ponle un nombre a cada hueco de la plantilla (por ejemplo «nombre» y «fecha»): así el agente sabe qué dato va en cada sitio.
Guarda y prueba la herramienta. Si Meta rechaza el envío, Atendy te dirá el motivo concreto en español.

Cuando creas una plantilla, Meta la revisa antes de poder usarla. Las de confirmación y recordatorio (categoría «utilidad») suelen aprobarse en minutos, aunque puede tardar hasta 24 horas. Mientras esté «en revisión» no se puede enviar con ella.

Los mensajes de WhatsApp los factura Meta directamente a tu cuenta, no Atendy. Necesitas un método de pago activo en Meta Business Suite: sin él, WhatsApp acepta los mensajes pero no los entrega. El consumo y el estado de cada mensaje los ves en tu propio panel de Meta.

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 o ficha por email

Si además conectas la herramienta de Email, el agente manda al cliente el estado del pedido, el enlace de seguimiento o la ficha y el enlace de un producto por correo. Reutiliza la misma integración de email (ver «Conectar tu email (SMTP)»), 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

En tu tienda, entra en WooCommerce → Ajustes → Avanzado → API REST y pulsa Añadir clave.
Ponle una descripción (por ejemplo, Atendy) y elige permiso de Solo lectura. Genera la clave.
Copia la clave de cliente (Consumer key) y el secreto de cliente (Consumer secret); el secreto solo se muestra una vez.
En Atendy, abre el asistente de herramientas del agente y elige la integración de WooCommerce.
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.
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».

PrestaShop (tu tienda online)

Si vendes con PrestaShop, Atendy trae una integración nativa por el Webservice de PrestaShop. El agente atiende por teléfono las llamadas más repetidas de una tienda —¿cómo va mi pedido?, ¿tenéis este producto?, ¿cuánto cuesta?— y responde con los datos reales de tu PrestaShop, en tiempo real. Reconoce al cliente por el número desde el que llama, consulta el estado de sus pedidos (por referencia, teléfono, email o DNI) y la información de productos (precio con impuestos y disponibilidad).

La conexión con PrestaShop es de solo lectura: el agente consulta pedidos y productos e informa, pero nunca cambia estados, precios ni stock.

Cómo conectar tu PrestaShop

En tu tienda, entra en Parámetros avanzados → Webservice y activa el Webservice.
Pulsa Añadir clave nueva: se genera una clave. Ponle una descripción (por ejemplo, Atendy).
En los permisos de esa clave, marca acceso de Lectura (GET) sobre: pedidos (orders), clientes (customers), direcciones (addresses), productos (products), estados de pedido (order_states) y stock (stock_availables). Guarda.
En Atendy, abre el asistente de herramientas del agente y elige la integración de PrestaShop.
Pega la dirección de tu tienda (https://tutienda.com) y la clave del Webservice. Elige qué activar: identificar al cliente, buscar pedidos, información de productos.
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). El agente reconoce al cliente por el teléfono si la tienda lo tiene guardado en la ficha del pedido; si el teléfono está anotado con espacios o guiones puede no reconocerlo, así que los datos más fiables para buscar un pedido son la referencia del pedido o el email.

Nota: PrestaShop tampoco da una fecha exacta de entrega, así que el agente no inventa un plazo. Da el estado del pedido y, si lleva número de seguimiento, para que lo consulte con el transportista.

Docfav (agenda de clínicas) · Beta

Si tu clínica lleva la agenda en Docfav, el agente trabaja directamente sobre ella: reconoce al paciente por el número desde el que llama, le dice sus próximas citas y le da, cambia o cancela cita en el gabinete que elijas, siempre en horas que Docfav da como libres.

Reconocer a quien llama

Al entrar la llamada busca al paciente por su teléfono y trae su nombre, su email, sus próximas citas y su última visita. Si llama desde otro número, el agente le pregunta con qué teléfono está registrado y su nombre, y lo busca: sin el nombre correcto no da ningún dato de esa ficha. Si varias personas comparten el teléfono (una familia), pregunta por quién llama. Nunca pasa al agente el DNI, la fecha de nacimiento ni las notas de la ficha.

Servicios y disponibilidad

Consulta los tratamientos del gabinete (duración y precio) y las horas libres por profesional, con filtro de mañana o tarde. El agente solo ofrece horas que Docfav da como libres.

Reservar, cambiar y cancelar

Reserva la cita siempre con los datos completos (nombre, apellidos, teléfono de contacto y email) y crea la ficha si el paciente es nuevo. Busca la ficha por el nombre entre todas las de ese teléfono, así una familia que comparte teléfono no acaba con fichas duplicadas ni con la cita en la ficha de otro. La nota de la cita guarda el teléfono de contacto y, si llamó desde otro número, también ese. Cambia la cita a otra hora libre o la cancela. Cancelar no borra: la cita queda como cancelada en el historial de Docfav.

Cómo conectar Docfav

En Docfav, entra en Ajustes → API y crea una clave nueva. Dale estos permisos: backofficeclinics:read, staff:read, services:read, clients:read, clients:write, appointments:read y appointments:write.
Copia la clave (empieza por df_): solo se enseña una vez.
En Atendy, abre las herramientas del agente y elige Docfav.
Pega la clave y escribe el nombre del gabinete tal como aparece en Docfav (si solo tienes uno, déjalo vacío). Atendy comprueba la clave y el gabinete al guardar.
Marca lo que quieres que haga el agente: reconocer a quien llama, consultar servicios, disponibilidad, reservar, consultar, cambiar o cancelar citas.
Prueba el agente con Probar agente antes de conectarlo a un número.

Para cambiar una cita, el agente reserva primero la nueva hora y solo después cancela la anterior: si la nueva no se puede reservar, la cita original sigue en pie. Solo toca citas del paciente cuyo teléfono se usa en la llamada.

Un agente solo puede tener un sistema de citas: la Agenda y CRM de Atendy, Cal.com, Google Calendar o Docfav. Con dos, el agente podría mirar los huecos en uno y reservar en el otro, así que Atendy no deja conectar el segundo. Para cambiar de sistema, desconecta antes el que tengas. La Agenda y CRM en modo «solo reconocer al cliente» (sin herramientas de citas) sí puede convivir con otro calendario.

Docfav limita las consultas por hora según tu plan. Cada llamada hace varias (reconocer al paciente consulta sus citas semana a semana). Si tu clínica recibe muchas llamadas, revisa el límite de tu plan de Docfav. La API de Docfav no permite añadir notas a la ficha del paciente: el resumen y la grabación de cada llamada se quedan en el Historial de Atendy.

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.

Variable	Qué 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 entrada	Cualquier 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 API	En 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.