Astrify FlowsAstrify FlowsMeta Business Partner

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.

Herramientas

n8n, Make y Zapier sin conector de pago

Usa el nodo de solicitud HTTP de esas herramientas con tu clave, y su webhook en el bloque “Disparar webhook”.

  • n8n
  • Make
  • Zapier
Los tokens de los canales y los secretos de los webhooks quedan cifrados, las direcciones internas se bloquean en las solicitudes que salen de la plataforma y la API respeta los permisos del cargo de quien creó la clave.

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.

PlanAl mesAPI RESTRecibir webhook y HTTP en el Workflow
Starter FreeGratis—Sí
LiteR$ 197,90—Sí
GrowthR$ 397,90SíSí
ProR$ 797,90SíSí
ScaleR$ 1.497,90Sí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.

Sí, desde Growth: una API REST con cerca de 128 rutas para leads, contactos, pipelines, tags, productos, propuestas, mensajes de WhatsApp, conversaciones, Workflows, campañas, correo, equipos, tareas, tableros y notificaciones.
Con una clave creada en Configuración › API abierta, enviada en el encabezado Authorization: Bearer. Cada clave tiene alcance por recurso (lectura o escritura), validez de 1 a 730 días, lista opcional de IP y registro de uso. Aparece solo una vez y se puede rotar o revocar.
120 solicitudes por minuto en cada clave, con respuesta 429 y el tiempo de espera cuando se supera ese límite. Cada empresa puede tener hasta 20 claves activas.
Por la ruta POST /v1/leads de la API, o por el trigger “Recibir webhook” de un Workflow, que da una dirección propia para que tu sistema, n8n, Make o Zapier envíen los datos. El antiguo webhook de leads con clave x-api-key ya no existe.
Los webhooks de salida envían los eventos del email marketing (abrió, hizo clic, respondió, canceló la suscripción, rebotado, queja y entró en la lista), firmados con HMAC-SHA256 y con reintentos. Para avisar a tu sistema de cambios en el pipeline, en las propuestas o en los pedidos, usa el bloque “Disparar webhook” o “Solicitud HTTP” en un Workflow.
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, y la plataforma tiene una página de documentación con autenticación, alcances, errores y ejemplos.
Astrify Flows

AAstrifyconversandoconelsistemade latuempresa.

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