Integración · Abierta

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 Disponible

Solicitar demo Ver qué viaja

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

Qué resuelve

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.

Qué hace

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.

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 se crea, se cierra o se responde un documento, o cambia un cliente, un contacto o un contrato.

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.

Qué viaja

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	Sentidode attendo a tu sistema	CuándoCuando tu sistema lo pide
Altas y cambios de documentos	Sentidode tu sistema a attendo	CuándoCuando tu sistema los envía
Clientes, contactos y contratos	Sentidoentre attendo y tu sistema, en los dos sentidos	CuándoCuando se piden o se envían
Activos, planes y proyectos	Sentidoentre attendo y tu sistema, en los dos sentidos	CuándoCuando se piden o se envían
Avisos de cambios (webhooks)	Sentidode attendo a tu sistema	CuándoCasi en tiempo real, con historial y reintento
Disparo de un flujo	Sentidode tu sistema a attendo	CuándoCuando tu sistema llama

Puesta en marcha

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 Disponible

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

El historial de entregas y el registro de peticiones dicen qué llegó, qué falló y por qué.

Honestidad

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, 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.

Sigue por aquí

Lo que va de la mano

Todas las 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.

¿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.

Configurar cookies