--- title: "API REST v4 y webhooks para integrar tu sistema | attendo" description: "La API REST v4 de attendo: documentos, clientes, contratos, activos y proyectos, con una clave por integración, permisos por operación y webhooks firmados." url: "https://attendo.me/integraciones/api-rest-y-webhooks" lang: "es" --- # API REST y webhooks: tu sistema habla con attendo Si tu sistema no está en la lista, esto es lo tuyo. La API REST v4 lee y escribe en attendo, y los webhooks avisan a tus sistemas cuando algo cambia. Un paso de los flujos llama a cualquier API sin programar. Estado - Una clave por integración - Permisos por área y por operación - Documentación interactiva attendo API REST - entre attendo y tu sistema, en los dos sentidos **Documentos, clientes y activos** Tu sistema lee y escribe - de attendo a tu sistema **Webhooks firmados** attendo avisa cuando algo cambia - de tu sistema a attendo **Disparo de flujos** Tu sistema lanza un flujo de attendo ## Cada lunes, alguien exporta a Excel Ninguna empresa vive en una sola herramienta. El ERP quiere saber qué se hizo en campo, la web quiere abrir avisos y el cuadro de mando quiere los tiempos reales. Sin API, alguien exporta a Excel cada lunes. Con la API, cada sistema habla con attendo directamente y con lo justo. Creas una clave por integración, le das solo lo que necesita y sabes quién llamó, a qué y cuándo. ## Lo que hace, pieza a pieza Tres piezas que se combinan: la API REST v4, los webhooks y el paso HTTP de los flujos. ### Lo que puedes leer y escribir Documentos y su historial, clientes, contactos y contratos, presupuestos, pedidos y albaranes, activos, proyectos, flujos y checklists. También los solicitantes, campo a campo, la planificación, las tareas, los formularios y las altas en listas de mailing. Los enlaces a ficheros van firmados y caducan a la hora. ### Una clave por integración Cada clave con su nombre, su caducidad, su responsable y su límite de peticiones. Se pausa o se revoca sin tocar las demás. ### Permisos por área y por operación Cada clave solo hace lo que le permites, y se comprueba en cada petición. Hay paquetes de partida: solo lectura, campo, comercial, ERP y asistente de IA. ### En nombre de una persona Una integración puede actuar en nombre de un usuario: lo que escribe queda a su nombre y solo ve lo que esa persona ve en pantalla. ### Webhooks firmados attendo avisa a tus sistemas cuando un documento se crea, se cierra, se responde o cambia de estado. También cuando se edita un activo, se envía un formulario o cambia un cliente, un contacto o un contrato. Si se elimina un cliente, el aviso lleva solo su identidad. ### Flujos que llaman a cualquier API Un paso de los flujos llama a cualquier API REST con los datos del documento. Y tu sistema lanza un flujo de attendo con una llamada. La documentación OpenAPI es interactiva: pruebas las llamadas desde el navegador antes de escribir una línea de código. Y una pantalla de actividad de la API enseña las peticiones, las entregas de webhooks y sus errores. ## Qué viaja y en qué sentido Con las mismas reglas que la pantalla: una etiqueta arrastra sus checklists y un documento consume su número de serie. Qué viaja entre attendo y API REST, en qué sentido y cuándo | Dato | Sentido | Cuándo | | --- | --- | --- | | Documentos, historial y adjuntos | de attendo a tu sistema | Cuando tu sistema lo pide | | Altas y cambios de documentos | de tu sistema a attendo | Cuando tu sistema los envía. Con clave de idempotencia, un reintento no crea otro | | Clientes, contactos y contratos | entre attendo y tu sistema, en los dos sentidos | Cuando se piden o se envían | | Activos, planes y proyectos | entre attendo y tu sistema, en los dos sentidos | Cuando se piden o se envían | | Avisos de cambios (webhooks) | de attendo a tu sistema | Casi en tiempo real, con historial y reintento | | Disparo de un flujo | de tu sistema a attendo | Cuando tu sistema llama | ## Cómo se pone en marcha Se configura desde Ajustes, sin intervención nuestra. La integración que la usa la hace tu equipo técnico o un partner, y te acompañamos si lo necesitas. Estado ### Qué necesitas - Un administrador de attendo que cree la clave - Un cliente HTTP en tu sistema: no hace falta ninguna librería - Para recibir webhooks, una dirección HTTPS que conteste en pocos segundos **Esfuerzo orientativo.** Crear una clave son minutos. El esfuerzo está en la integración que la usa: la hace tu equipo técnico o un partner. ### Paso 1 · Crear la clave Con el nombre de la integración, su caducidad, los permisos justos y un responsable. El secreto se enseña una sola vez. ### Paso 2 · Probar en la documentación Autorizas la clave en la documentación interactiva y pruebas las llamadas antes de programar. ### Paso 3 · Suscribir los webhooks Eliges los eventos, guardas el secreto de firma y mandas una prueba a tu receptor. ### Paso 4 · Vigilar la primera semana La pantalla de actividad de la API dice qué peticiones llegaron, qué entregas fallaron y por qué. ## Qué no hace - **Configuración de la instancia** Tipos de documento, campos y permisos se configuran en pantalla, no por API. - **Alta de usuarios** Por API se listan, se activan y se desactivan; el alta se hace en pantalla. - **Importes por su cuenta** Precios, impuestos y numeración salen de los mismos cálculos que la pantalla. - **Todos los cambios por webhook** Hay eventos de documentos, activos, formularios, clientes, contactos y contratos. Para lo demás, tu sistema consulta el historial por API. - **Orden de los avisos** Tu receptor debe aceptar avisos repetidos o desordenados. ## Lo que va de la mano - [attendo + MCP](https://attendo.me/integraciones/mcp): Tu asistente de IA consulta attendo con los permisos de cada persona. - [attendo Flows](https://attendo.me/flows): Flujos, aprobaciones y formularios sin código. - [Tecnología](https://attendo.me/tecnologia): Arquitectura, despliegue y API. - [Seguridad](https://attendo.me/seguridad): Datos en la UE, permisos y trazabilidad. [Todas las integraciones](https://attendo.me/integraciones) Cada conexión, con su estado real. ## Preguntas frecuentes ### ¿Qué versión uso si empiezo hoy? La API v4. Contiene todo lo de las versiones anteriores, que se retiran el 31 de marzo de 2027. ### ¿Puedo dar a una integración solo lectura de clientes? Sí. Le das a la clave el permiso de lectura de clientes y, si quieres afinar más, la restringes por operación. ### ¿Qué pasa si se filtra una clave? La revocas en Ajustes y deja de funcionar al instante. Las demás integraciones siguen igual. ### ¿Cuántas llamadas puedo hacer? 120 por minuto por clave de serie, ampliable por clave o para toda la instancia. ### ¿Cómo sé que un aviso viene de attendo? Cada webhook va firmado con tu secreto. Tu receptor comprueba la firma y rechaza los avisos antiguos. ### ¿Hay librerías? Es REST con JSON: sirve cualquier cliente HTTP. ## Cuéntanos qué quieres conectar Te enseñamos qué haría la API con tu sistema y qué parte le toca a tu equipo técnico. - Con tu operación, no con una demo genérica - Te contesta una persona del equipo - Sin llamadas frías después ¿Prefieres hablar antes? - Teléfono [+34 910 053 530](tel:+34910053530) - Correo [sales@attendo.me](mailto:sales@attendo.me) - De lunes a jueves de 9:30 a 18:30 y los viernes de 9:30 a 14:30