Para desarrolladores
API REST y webhooks para integrar Astrify
Crea leads, envía mensajes, mueve tableros y activa Workflows desde tu sistema, recibe datos por webhook y llama a cualquier API en medio de un flujo, con claves por alcance y documentación OpenAPI.
- OpenAPI 3.1 y Postman
- Claves con alcance
- Desde Growth
Terminal
curl -X POST https://api2.astrify.com.br/v1/leads \
-H "Authorization: Bearer astrify_7f3k…" \
-H "Content-Type: application/json" \
-d '{
"nome": "Paula Mendes",
"telefone": "+5511955550000",
"email": "paula@email.com"
}'201 Created
{
"id": "ld_8c21…",
"nome": "Paula Mendes",
"etapa": "Novo lead",
"funil": "Vendas"
}- 128
rutas en la API, de leads y mensajes a tableros y propuestas
- 16
recursos con alcance de lectura o escritura por clave
- 120
solicitudes por minuto en cada clave
- 20
claves activas por empresa, cada una con su registro de uso
API REST
Qué hace la API
Elige el recurso y mira algunas rutas.
Leads y pipeline
Crea y actualiza leads, une duplicados, importa en lote y registra actividades y notas. El pipeline y las etapas se leen por la API.
- Crear, listar, actualizar, eliminar y unir leads
- Importación en lote y búsqueda de duplicados
- Actividades, notas, participantes y artículos del deal
- Pipelines, etapas, orígenes y motivos de pérdida (lectura)
api2.astrify.com.br/v1
- POST/leads
- GET/leads
- PATCH/leads/{lead_id}
- POST/leads/importar-lote
- GET/funis/{funil_id}/etapas
Claves de API
Cada integración con tu clave
Las claves se crean en Configuración › API abierta y se envían en el encabezado Authorization. Actúan como quien las creó y dejan de funcionar si esa persona se desactiva.
- 01
Alcance por recurso
Cada clave solo lee o escribe lo que marques: leads, contactos, tableros, mensajes y el resto.
- 02
Validez e IP
Validez de 1 a 730 días y lista de hasta 20 IP autorizadas.
- 03
Se muestra una vez
La clave aparece solo al crearla; Astrify guarda únicamente una firma de ella.
- 04
Rotar y revocar
Cambia la clave sin detener la integración y revócala al instante, con el registro de uso de cada una.
Webhook de entrada
Tu sistema avisa, el Workflow actúa
El trigger “Recibir webhook” da al Workflow una dirección propia. Envía el JSON de tu sistema, de n8n, de Make o de Zapier, encuentra el lead por correo o teléfono y sigue el flujo. En el modo escucha, Astrify muestra el primer envío para que mapees los campos antes de activar.
- GET, POST, PUT y PATCH, hasta 256 KB
- Modo escucha de 2 minutos para ver el envío real
- Últimos 50 eventos guardados en cada trigger
- Hasta 120 llamadas por minuto en cada dirección
POST /api/webhooks/workflow/{token}
{
"evento": "pagamento_aprovado",
"cliente": {
"nome": "João Prado",
"email": "joao@pradoalimentos.com.br"
},
"valor": 1290.00
}De Astrify a tu sistema
Dos caminos, según lo que necesites saber.
En el Workflow
Solicitud HTTP y Disparar webhook
Cualquier trigger (lead cambió de etapa, propuesta aceptada, pedido entregado) puede llamar a tu sistema en medio del flujo y usar la respuesta en los siguientes bloques.
- GET, POST, PUT, PATCH y DELETE con encabezados y cuerpo JSON
- Variables del lead en la URL y en el cuerpo
- Respuesta guardada en una variable para el Si/Si no
- Esperar la respuesta o disparar y seguir
Webhooks de salida
Eventos del email marketing
Registra hasta 10 direcciones en Configuración › Webhooks y recibe cada evento firmado, con reintentos y el historial de entregas.
- email.opened
- email.clicked
- email.replied
- email.unsubscribed
- email.bounced
- email.complaint
- email.list_joined
- Firma HMAC-SHA256 en el encabezado X-Astrify-Signature
- Reintentos a 1 min, 5 min, 30 min, 2 h y 6 h
- Historial con reenvío y botón de prueba
Documentación
OpenAPI, Postman y la guía en la plataforma
La especificación OpenAPI 3.1 y la colección de Postman están abiertas en api2.astrify.com.br/v1/openapi.json y /v1/postman.json. Dentro de la plataforma, la página de documentación explica autenticación, alcances, errores y ejemplos de cada ruta.
Planes
API en cada plan
La API REST y las claves están disponibles desde Growth. El trigger “Recibir webhook” y los bloques de solicitud están en todos los planes, dentro de los Workflows.
| Plan | Al mes | API REST | Recibir webhook y HTTP en el Workflow |
|---|---|---|---|
| Starter Free | Gratis | — | Sí |
| Lite | R$ 197,90 | — | Sí |
| Growth | R$ 397,90 | Sí | Sí |
| Pro | R$ 797,90 | Sí | Sí |
| Scale | R$ 1.497,90 | Sí | Sí |
Al mes, en reales brasileños (BRL); en el anual pagas 10 meses y usas 12. Ver todos los planes
Continúa por aquí
Preguntas frecuentes
Lo que preguntan los desarrolladores antes de integrar.

AAstrifyconversandoconelsistemade latuempresa.
Prueba los Workflows con webhook en el plan gratuito y desbloquea la API desde Growth.
























