API REST y webhooks

API REST pública con varias API keys y webhooks firmados

Da de alta clientes desde tu web, tu formulario o tu backend con una llamada HTTP, y recibe cada cambio en tu servidor firmado con HMAC-SHA256.

Tu CRM deja de ser un sitio al que hay que entrar a escribir: pasa a ser un endpoint al que tus sistemas llaman.

AiCrm, la app de CRM de AIsToHire, expone una API REST pública sobre tus propios contactos. Con una clave en la cabecera `X-Api-Key` puedes crear, listar, consultar, actualizar y borrar contactos, y añadir actividades a cualquiera de ellos, desde el formulario de tu web, tu chatbot, un Zap, un script de Python o tu propio backend. Las respuestas son JSON con la forma `{ success, data }`, y el límite es de 100 peticiones por minuto y clave.

El alta por API no duplica: si el email que envías ya existe en tu base, AiCrm actualiza la ficha que ya tenías (completa el teléfono, el nombre o la empresa que faltaran, une las etiquetas) y registra un nuevo envío en su timeline, devolviendo HTTP 200; si es nuevo, lo crea y devuelve 201. Cada contacto que entra por API se etiqueta automáticamente como `api-lead`, conserva las etiquetas que tú mandes y guarda el `subId` de origen, además del país, la IP y el navegador desde los que llegó.

Puedes tener hasta 20 API keys con nombre propio, además de la clave interna de la app. Así das una clave distinta a cada integración —la web, el formulario de la campaña de mayo, el becario, el proveedor— y la revocas sola cuando esa integración termina, sin tocar las demás. El valor completo de una clave se muestra una única vez, al crearla; después solo se ve enmascarada en el listado.

En la otra dirección, los webhooks avisan a tus sistemas. Configuras hasta 10 destinos, eliges a qué eventos se suscribe cada uno (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) y AiCrm hace un POST a tu URL con las cabeceras `X-AiCrm-Event` y `X-AiCrm-Signature: sha256=…`, la firma HMAC-SHA256 del cuerpo con el secreto de ese webhook, para que verifiques que la entrega es legítima. Al guardar la URL, una guarda anti-SSRF rechaza localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 y los dominios `.local` e `.internal`.

Ventajas de API REST y webhooks

Alta de contactos con una sola llamada

un POST a `/api/apps/public/crm/customers` con el email y las etiquetas que quieras, y el lead ya está en tu CRM clasificado.

Sin duplicados por diseño

si el email ya existe, se actualiza la ficha y se apunta el nuevo envío en su timeline en lugar de crear una segunda ficha.

Hasta 20 claves con nombre

una por integración, revocable por separado. Si una clave se filtra, borras esa y nada más deja de funcionar.

Webhooks firmados con HMAC-SHA256

verificas la cabecera `X-AiCrm-Signature` con tu secreto y sabes que el aviso viene de tu CRM y no de un tercero.

Guarda anti-SSRF incluida

la app se niega a entregar webhooks a localhost o a rangos de red privados, así que tu CRM no puede usarse para sondear una red interna.

CRUD completo, no solo altas

listar con paginación y filtros (búsqueda, estado, etiquetas, país), consultar un contacto con su actividad, actualizarlo, borrarlo y registrarle actividades.

Origen trazado automáticamente

cada alta por API guarda el `subId` que envías más el país, la IP y el navegador, y queda etiquetada como `api-lead` para filtrarla luego en la app.

Pruebas sin adivinar

la app trae la documentación de los endpoints con un ejemplo de `curl` copiable y un botón para enviar una entrega de prueba a cada webhook, con el estado y la hora del último intento.

Claire Donovan

Conecta tu web con tu CRM esta misma tarde

AiCrm es la herramienta de CRM de AIsToHire que recibe tus contactos por API REST y avisa a tus sistemas con webhooks firmados. Crea tu cuenta, genera una clave y haz la primera llamada.

API REST para CRM con webhooks firmados | AiCrm