Workflows de Attio: cómo funciona la automatización del CRM en Attio
Por Roman Zakharenko · Datos verificados · 6 min de lectura
Attio automatiza el trabajo del CRM con workflows. Un workflow empieza en un bloque trigger y ejecuta una cadena de bloques de acción, como actualizar un registro, crear una tarea, enviar un mensaje de Slack o hacer una solicitud HTTP. Las ejecuciones de workflows consumen créditos del espacio de trabajo, y todo lo demás se conecta a través de la API REST y los webhooks de Attio.
De un vistazo
- Un workflow de Attio se compone de un bloque trigger, que lo inicia, y de bloques de acción, que hacen el trabajo.
- Los workflows consumen créditos del espacio de trabajo. La mayoría de los bloques consumen un crédito, y un bloque que falla, junto con todos los bloques posteriores, no consume ninguno.
- La API REST de Attio permite 100 solicitudes de lectura y 25 de escritura por segundo. Si se supera el límite, devuelve HTTP 429 con una cabecera Retry-After.
- Attio firma los webhooks con un HMAC-SHA256 del cuerpo de la solicitud, enviado en la cabecera Attio-Signature.
Cómo se construyen los workflows de Attio
Un workflow se construye en un lienzo. El bloque trigger decide cuándo se ejecuta, y los bloques de acción que vienen después deciden qué ocurre. La biblioteca de bloques de Attio agrupa los triggers en cuatro tipos:
- Triggers de registro, como 'Record created'.
- Triggers de lista, como 'Record added to list'.
- Triggers de tarea, como 'Task created'.
- Triggers de utilidad, como 'Manual run', una programación o un webhook entrante.
El centro de ayuda de Attio pone como ejemplos de bloques de acción actualizar un registro, crear una tarea, enviar un mensaje de Slack, inscribir a alguien en una secuencia y hacer una solicitud HTTP. También puedes describir un workflow en lenguaje natural y dejar que Ask Attio lo cree. Las apps creadas con el Attio SDK pueden añadir sus propios bloques, que después aparecen en el selector de bloques junto a los integrados.
Por defecto, un workflow no puede escribir en un objeto. Un administrador, o un miembro con acceso completo a ese objeto, tiene que dar antes acceso al workflow. Compruébalo antes de probar un workflow que actualiza registros.
Cómo consumen créditos los workflows
Las ejecuciones de workflows y las funciones de IA consumen los créditos compartidos del espacio de trabajo. La documentación de facturación de Attio describe cómo se cuentan:
- La mayoría de los bloques de workflow consumen un crédito cada vez que se ejecutan.
- Solo se cobran créditos por los bloques que se ejecutan realmente. Si una ejecución falla a mitad, el bloque que falla y todos los bloques posteriores no consumen créditos.
- Recalcular atributos de IA también consume créditos.
- Los administradores pueden ver el consumo de créditos por workflow en Workspace settings.
El número de créditos incluidos varía según el plan, y Attio ya ha cambiado sus planes en el pasado. Consulta la asignación vigente en la página de precios de Attio y estima el consumo multiplicando el número de bloques por ejecución por las ejecuciones que esperas al mes.
La API y los webhooks de Attio
Para todo lo que un workflow no puede hacer por sí solo, Attio tiene una API REST y webhooks salientes. Esto es lo que dice la documentación para desarrolladores sobre cada uno.
| Tema | Qué documenta Attio |
|---|---|
| Límites de tasa | 100 solicitudes por segundo para lecturas y 25 por segundo para escrituras. Si se supera el límite, HTTP 429 con una cabecera Retry-After. |
| Endpoints de listado | List records y List entries tienen además límites basados en puntuación, contados en una ventana de 10 segundos para todas las apps y tokens. |
| Autenticación | Una clave de API para un solo espacio de trabajo, u OAuth 2.0 para apps que se usan en varios espacios de trabajo. Los tokens se envían como Bearer tokens, y los scopes se definen por token. |
| Eventos de webhook | Entre los eventos están record.created, list-entry.created, note.created y task.created. |
| Firma del webhook | Un HMAC-SHA256 del cuerpo sin procesar de la solicitud, generado con el secreto del webhook y codificado en hexadecimal, en la cabecera Attio-Signature. |
| Reintentos | Cada mensaje lleva una cabecera Idempotency-Key que no cambia cuando Attio lo reintenta. |
Para comprobar que un webhook viene de Attio, vuelve a calcular el HMAC-SHA256 del cuerpo sin procesar con el secreto del webhook y compáralo con la cabecera Attio-Signature. Attio también envía el mismo valor como X-Attio-Signature para middleware más antiguo. Usa la cabecera Idempotency-Key para omitir los mensajes que ya has procesado, de modo que un reintento no cree una segunda tarea o un segundo mensaje de Slack.
Conectar Attio con tus herramientas de soporte
Attio tiene una app de Slack para notificaciones y una app oficial de Zapier. Zapier muestra conexiones ya preparadas entre Attio y helpdesks como Zendesk e Intercom. Para tener más control, conecta un helpdesk a la API y los webhooks de Attio mediante n8n o Make. Este es un patrón habitual, descrito paso a paso. Muestra cómo encajan las piezas. No es un caso de éxito de TascaLab.
- Trigger: tu helpdesk envía un webhook a n8n o Make cuando se crea o se escala un ticket.
- Búsqueda: el workflow encuentra el registro de la empresa del cliente en Attio a través de la API, sin salirse del límite de 100 lecturas por segundo.
- Actualización: escribe el estado o la categoría del ticket en un atributo del registro, o crea una tarea para el responsable de la cuenta.
- Reacción en Attio: un workflow de Attio que se activa con esa actualización del registro envía un mensaje de Slack al responsable de la cuenta.
- Gestión de errores: espera y reintenta ante un HTTP 429, y usa la cabecera Idempotency-Key para descartar las entregas de webhook duplicadas.
Cómo ponerlo en marcha
TascaLab conecta herramientas como Attio con las herramientas de helpdesk y de chat que ya usas, mediante APIs, webhooks, n8n y Make, sin cambiar de plataforma. Los proyectos de Custom Automation cuestan desde 1070 €. La mayoría de las implementaciones llevan de 1 a 3 semanas, y todos los proyectos incluyen documentación básica y 30 días de soporte tras el lanzamiento. Puedes empezar con una llamada de Health Check gratuita de 30 minutos.
Preguntas frecuentes
¿Qué son los workflows de Attio?
La herramienta de automatización de Attio. Un workflow empieza en un bloque trigger, como la creación de un registro o una ejecución manual, y después ejecuta bloques de acción, como actualizar un registro, crear una tarea, enviar un mensaje de Slack o hacer una solicitud HTTP.
¿Los workflows de Attio consumen créditos?
Sí. Las ejecuciones de workflows consumen los créditos compartidos del espacio de trabajo. La mayoría de los bloques consumen un crédito por ejecución, y los bloques que fallan o que nunca se ejecutan no consumen ninguno. El número de créditos incluidos depende de tu plan.
¿Cuáles son los límites de tasa de la API de Attio?
100 solicitudes por segundo para lecturas y 25 por segundo para escrituras. Si se supera el límite, Attio devuelve HTTP 429 con una cabecera Retry-After. Los endpoints List records y List entries tienen además límites basados en puntuación.
¿Cómo verifico un webhook de Attio?
Calcula un HMAC-SHA256 del cuerpo sin procesar de la solicitud con el secreto del webhook, codifícalo en hexadecimal y compáralo con la cabecera Attio-Signature.
¿Quieres que lo configure para tu equipo?
Reserva un Health Check gratuito: una llamada de 30 minutos y un informe por escrito con 2–3 recomendaciones concretas, un precio fijo y los costes de funcionamiento estimados. Sin discurso de ventas.
Fuentes
- Attio Help — Overview of workflows
- Attio Help — Workflows block library
- Attio Help — Create a workflow
- Attio Help — Automations billing
- Attio Docs — Rate limiting
- Attio Docs — Authentication
- Attio Docs — Webhooks
- Attio Docs — Workflow blocks (SDK)
- Attio Help — Communication apps (Slack)
- Attio Help — Zapier app
- Zapier — Attio and Zendesk integrations