API: conecta iAgentify con tus propios sistemas

iAgentify tiene una API REST para que tu propio servidor hable con un agente y se lleve los leads a tu CRM. Se usa con claves de API, que crean los administradores y propietarios en Ajustes › API. Que la API responda depende de tu plan. Es una herramienta para quien programa: si no tienes a esa persona, no la necesitas para usar iAgentify.

Qué permite hacer

La API tiene tres llamadas:

Lo que pasa por la API se trata como cualquier otra conversación:

• Aparece en Conversaciones, con el aviso «Escribe a través de la API», y tu equipo puede tomar el control.
• Cada respuesta gasta créditos, igual que en el chat de tu web o en WhatsApp.
• El agente responde con el mismo conocimiento y las mismas instrucciones. Puede captar un lead o pasar la conversación a una persona, y la respuesta de la llamada lo indica.
• Si una persona lleva la conversación, está en pausa o el agente no está activo, la llamada no devuelve respuesta del agente.

Qué no permite

• No crea ni configura agentes, ni añade conocimiento, ni gestiona citas, conversaciones o el equipo. Eso se hace en la aplicación.
• No hay webhooks. iAgentify no llama a tu sistema cuando entra un lead o un mensaje: tu servidor pregunta cada cierto tiempo, por ejemplo por los leads creados desde la última consulta.
• No hay respuesta en streaming. La respuesta llega entera, al terminar.
• No hay conectores hechos para CRM concretos ni para herramientas de automatización. La integración la programa quien lleva tus sistemas.

Si solo quieres los leads en una hoja de cálculo, no hace falta la API: ver exportar tus leads.

Qué necesitas

• Un plan que la incluya. A 6 de octubre de 2026 la incluyen los planes Estándar y Premium, y el plan Básico no. Si tu plan no la incluye, en Ajustes › API verás «Tu plan no incluye acceso por API»: puedes preparar tus claves, pero la API rechaza las llamadas hasta que cambies de plan.
• Rol. Necesitas ser Administrador o Propietario. El resto del equipo no ve esta sección.
• Un servidor propio. La clave no se puede poner en una página web ni en una aplicación móvil: quien la vea puede usar tus agentes y leer tus leads.

Crear una clave

1. Entra en Ajustes y abre la pestaña API. También puedes ir directamente a Ajustes › API (se abre la aplicación).

2. En Claves de API, pulsa Crear clave.

3. Escribe el Nombre de la clave: uno que te diga dónde se usa, como «Integración con el CRM».

4. Pulsa Crear clave. Aparece «Guarda tu clave ahora» con la clave completa.

5. Cópiala y guárdala en un lugar seguro. Después pulsa Ya la he guardado.

Crea una clave por integración: así puedes revocar una sin parar las demás. Caben 10 claves activas por cuenta. La lista muestra el Último uso de cada una, que sirve para saber cuáles siguen vivas.

Revocar una clave

1. En Claves de API, pulsa el botón de revocar de la clave.

2. Confirma con Revocar clave. Aparece «Clave revocada».

Las integraciones que la usen dejan de funcionar al momento, y no se puede deshacer. Revoca una clave siempre que sospeches que alguien de fuera la ha visto, y cuando deje el equipo quien la tenía.

Dónde está la documentación

En la misma pantalla, debajo de las claves, el apartado Cómo usar la API tiene todo lo que necesita quien la programa: la URL base, cómo enviar la clave en la cabecera Authorization, cada llamada con sus parámetros y un ejemplo que se puede copiar, y los errores. Pásale esa pantalla a tu desarrollador, o dale el rol Administrador para que la vea.

Los datos que más se preguntan:

Errores habituales

Si una llamada falla y no sabes por qué, abre un ticket desde Soporte con la hora aproximada y el texto del error. No pegues la clave en el ticket.