Desarrolladores

Conecta cualquier aplicación, agente de IA o automatización al CRM de IAlgo+ mediante una API REST con especificación OpenAPI. Crea y consulta leads, contactos, empresas y oportunidades de forma programada.

Documentación interactiva Especificación OpenAPI (JSON) Guía para agentes (llms.txt)

1 · Consigue tu clave de API

Cada cliente genera sus propias claves desde su espacio del CRM, en Integraciones → Tokens de API (crm.ialgomas.io). Una clave pertenece siempre a una empresa (el CRM es multiempresa) y hereda sus permisos. Guarda la clave en un lugar seguro — en el servidor, nunca en el navegador ni en el código cliente.

2 · Autenticación

Todas las llamadas viajan por HTTPS e incluyen tu clave en una cabecera. Puedes usar cualquiera de las dos formas:

Authorization: Bearer TU_CLAVE
# o bien
X-Api-Key: TU_CLAVE

Sustituye TU_CLAVE por el token real. Si falta o no es válida, la API responde 401 con un cuerpo JSON de error.

3 · Base y formato

Base URL: https://ialgomas.io/api/v1 (o la canónica https://crm.ialgomas.io/api/v1).
Contenido: JSON en peticiones y respuestas (Content-Type: application/json).
Métodos: GET listar/ver, POST crear, PUT/PATCH actualizar, DELETE borrar.

4 · Primera llamada (quickstart)

Crear un lead entrante desde una web o formulario:

curl -X POST https://ialgomas.io/api/v1/leads \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "Interes en el plan Pro",
        "contact_name": "Ana Garcia",
        "email": "ana@acme.com",
        "phone": "600123123",
        "source": "web"
      }'

Listar las últimas oportunidades:

curl https://ialgomas.io/api/v1/opportunities \
  -H "Authorization: Bearer TU_CLAVE"

5 · Endpoints principales

GET/api/v1/leadsListar leads

POST/api/v1/leadsCrear un lead

GET/api/v1/contactsListar contactos

GET/api/v1/accountsListar empresas

GET/api/v1/opportunitiesListar oportunidades del pipeline

PUT/api/v1/opportunities/{id}Actualizar una oportunidad

DELETE/api/v1/leads/{id}Eliminar un lead

La lista completa, con parámetros, esquemas y códigos de respuesta, está en la documentación interactiva y en la especificación OpenAPI.

6 · Errores

Los errores se devuelven siempre en JSON estructurado, con un código, un mensaje legible y (cuando aplica) el detalle por campo:

{
  "error": {
    "code": "unauthorized",
    "message": "Falta la clave de API o no es valida.",
    "hint": "Envia la cabecera Authorization: Bearer TU_CLAVE"
  }
}

Código HTTP	Significado
`400`	Petición mal formada (JSON inválido o parámetro incorrecto).
`401`	Clave de API ausente o no válida.
`403`	La clave no tiene permiso para ese recurso.
`404`	El recurso solicitado no existe.
`422`	Validación: faltan campos o tienen un formato incorrecto.
`429`	Demasiadas peticiones; reintenta más tarde.

7 · Uso con agentes de IA

La especificación OpenAPI en /openapi.json incluye operationId, descripciones y esquemas tipados para cada operación, de modo que un agente puede convertirla directamente en herramientas de function calling. La guía /llms.txt resume cuándo conviene usar IAlgo+ y cómo llamar a la API.

¿Dudas de integración? Escríbenos a info@ialgomas.io.