API de Agentclic

Con la API de Agentclic conectas tu cuenta con otras herramientas, como n8n, Make, Zapier o tu propio código. Por ejemplo, puedes enviar al CRM de un cliente los leads que recoges en otra plataforma. Se usa con un token que creas en Ajustes › API, y cada llamada consume créditos de tu cuenta.

#Antes de empezar

• La API está incluida en el plan Agentes ilimitados. Ver Planes y créditos.
• La documentación técnica (direcciones, ejemplos y errores) está en la documentación para desarrolladores.

#Crear un token

1. Entra en Ajustes y abre la pestaña API.
2. Pulsa Crear token.
3. Ponle un nombre que te diga para qué es, por ejemplo «n8n leads Clínica Sol».
4. Elige los permisos: Contactos · leer o Contactos · leer y escribir.
5. En Clientes, elige Todos mis clientes o limítalo a uno solo.
6. Elige la caducidad: 30 días, 90 días, 1 año, una fecha concreta o Sin caducidad.
7. La primera vez, acepta las condiciones de la API.
8. Pulsa Crear token y copia el token. Solo se muestra una vez.

Cada vez que se crea un token en tu cuenta te llega un email de aviso.

#Qué puedes hacer con la API

Con la API trabajas con los datos de tus propios clientes, los mismos que ves en tu panel:

• Ver tus clientes.
• Ver, crear y actualizar los contactos del CRM de un cliente, con su etapa y sus campos personalizados.

Los contactos que se crean por la API aparecen en Contactos con el origen API. Ver Contactos.

#Créditos

• Cada llamada correcta consume créditos. El coste está en Ajustes › Créditos e IA › Coste de cada acción, como «Llamada a la API de Agentclic».
• Las llamadas que terminan en error no consumen créditos.
• Lo que haces desde el panel o la app no se cobra por llamada.
• Las acciones que ya consumen créditos, como las respuestas de los agentes, los siguen consumiendo igual.
• Si te quedas sin créditos, la API rechaza las llamadas hasta que recargues.

En Ver movimientos aparece un movimiento «Llamadas a la API» por token y día, con el número de llamadas. En Ajustes › API ves, por cada token, cuándo se usó por última vez, sus llamadas y los créditos que ha gastado. Ver Créditos.

#Revocar un token

En Ajustes › API, pulsa Revocar en el token y confírmalo. Deja de funcionar al momento y no se puede deshacer: si lo necesitas otra vez, crea uno nuevo.

#Problemas frecuentes

#No veo la pestaña API o dice que no está disponible

La API está incluida en el plan Agentes ilimitados. Si tienes el plan Por agente, puedes cambiar de plan en Ajustes › Plan y agentes.

#He perdido el token

No se puede volver a mostrar. Revócalo y crea uno nuevo.

#La herramienta dice que no quedan créditos

Recarga créditos en Ajustes › Créditos e IA. Las llamadas vuelven a funcionar en cuanto tienes saldo.