Astrify FlowsAstrify FlowsMeta Business Partner

Voor ontwikkelaars

REST API en webhooks om Astrify te integreren

Maak leads aan, stuur berichten, werk met de boards en start Workflows vanuit uw eigen systeem, ontvang gegevens via webhook en roep midden in een flow elke API aan, met sleutels per scope en OpenAPI-documentatie.

  • OpenAPI 3.1 en Postman
  • Sleutels met scope
  • Vanaf 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

    routes in de API, van leads en berichten tot boards en offertes

  • 16

    resources met lees- of schrijfscope per sleutel

  • 120

    verzoeken per minuut per sleutel

  • 20

    actieve sleutels per bedrijf, elk met zijn eigen gebruikslog

REST API

Wat de API doet

Kies de resource en zie enkele routes.

Leads en pipeline

Maak en update leads, voeg duplicaten samen, importeer in bulk en leg activiteiten en notities vast. De pipeline en de stages worden via de API uitgelezen.

  • Leads aanmaken, weergeven, bijwerken, verwijderen en samenvoegen
  • Bulkimport en zoeken naar duplicaten
  • Activiteiten, notities, deelnemers en items van de deal
  • Pipelines, stages, herkomsten en verliesredenen (alleen lezen)

api2.astrify.com.br/v1

  • POST/leads
  • GET/leads
  • PATCH/leads/{lead_id}
  • POST/leads/importar-lote
  • GET/funis/{funil_id}/etapas

API-sleutels

Elke integratie met uw eigen sleutel

De sleutels maakt u aan in Instellingen › Open API en verstuurt u in de Authorization-header. Ze handelen namens wie ze heeft aangemaakt en stoppen als die persoon wordt gedeactiveerd.

  • 01

    Scope per resource

    Elke sleutel leest of schrijft alleen wat u aanvinkt: leads, contacten, boards, berichten en de rest.

  • 02

    Geldigheid en IP's

    Geldigheid van 1 tot 730 dagen en een lijst met maximaal 20 toegestane IP's.

  • 03

    Eenmalig getoond

    De sleutel wordt alleen bij het aanmaken getoond; Astrify bewaart alleen een handtekening ervan.

  • 04

    Roteren en intrekken

    Vervang de sleutel zonder de integratie te stoppen en trek hem direct in, met het gebruikslog van elke sleutel.

Inkomende webhook

Uw systeem meldt, de Workflow handelt

De trigger “Webhook ontvangen” geeft de Workflow een eigen adres. Stuur de JSON van uw systeem, van n8n, van Make of van Zapier, zoek de lead op via e-mail of telefoonnummer en volg de flow. In de luistermodus toont Astrify de eerste verzending zodat u de velden kunt toewijzen voordat u inschakelt.

  • GET, POST, PUT en PATCH, tot 256 KB
  • Luistermodus van 2 minuten om de echte verzending te zien
  • Laatste 50 gebeurtenissen bewaard bij elke trigger
  • Tot 120 aanroepen per minuut per adres

POST /api/webhooks/workflow/{token}

{
  "evento": "pagamento_aprovado",
  "cliente": {
    "nome": "João Prado",
    "email": "joao@pradoalimentos.com.br"
  },
  "valor": 1290.00
}

Van Astrify naar uw systeem

Twee routes, afhankelijk van wat u wilt weten.

In de Workflow

HTTP-verzoek en Webhook starten

Elke trigger (lead naar andere stage verplaatst, offerte geaccepteerd, bestelling geleverd) kan midden in de flow uw systeem aanroepen en het antwoord in de volgende blokken gebruiken.

  • GET, POST, PUT, PATCH en DELETE met headers en JSON-body
  • Variabelen van de lead in de URL en in de body
  • Antwoord opgeslagen in een variabele voor het Als/Anders
  • Op het antwoord wachten of verzenden en doorgaan

Uitgaande webhooks

Gebeurtenissen van e-mailmarketing

Registreer tot 10 adressen in Instellingen › Webhooks en ontvang elk gebeurtenis ondertekend, met nieuwe pogingen en de leveringsgeschiedenis.

  • email.opened
  • email.clicked
  • email.replied
  • email.unsubscribed
  • email.bounced
  • email.complaint
  • email.list_joined
  • HMAC-SHA256-handtekening in de X-Astrify-Signature-header
  • Nieuwe pogingen na 1 min, 5 min, 30 min, 2 u en 6 u
  • Geschiedenis met opnieuw verzenden en testknop

Documentatie

OpenAPI, Postman en de gids in het platform

De OpenAPI 3.1-specificatie en de Postman-collectie zijn openbaar op api2.astrify.com.br/v1/openapi.json en /v1/postman.json. Binnen het platform legt de documentatiepagina authenticatie, scopes, fouten en voorbeelden van elke route uit.

Tools

n8n, Make en Zapier zonder betaalde connector

Gebruik de HTTP-verzoeknode van die tools met uw sleutel, en hun webhook in het blok “Webhook starten”.

  • n8n
  • Make
  • Zapier
Tokens van de kanalen en geheimen van de webhooks blijven versleuteld, interne adressen worden geblokkeerd in de verzoeken die het platform verlaten en de API respecteert de rechten van de rol van wie de sleutel heeft aangemaakt.

Plannen

API per plan

De REST API en de sleutels zijn beschikbaar vanaf Growth. De trigger “Webhook ontvangen” en de verzoekblokken zitten in alle plannen, binnen de Workflows.

PlanPer maandREST APIWebhook ontvangen en HTTP in de Workflow
Starter FreeGratis—Ja
LiteR$ 197,90—Ja
GrowthR$ 397,90JaJa
ProR$ 797,90JaJa
ScaleR$ 1.497,90JaJa

Per maand, in Braziliaanse reais (BRL); bij jaarbetaling betaalt u 10 maanden en gebruikt u er 12. Alle plannen bekijken

Ga hier verder

Veelgestelde vragen

Wat ontwikkelaars vragen voordat ze integreren.

Ja, vanaf Growth: een REST API met ongeveer 128 routes voor leads, contacten, pipelines, tags, producten, offertes, WhatsApp-berichten, gesprekken, Workflows, campagnes, e-mail, teams, taken, boards en meldingen.
Met een sleutel die u aanmaakt in Instellingen › Open API en verstuurt in de header Authorization: Bearer. Elke sleutel heeft een scope per resource (lezen of schrijven), een geldigheid van 1 tot 730 dagen, een optionele lijst met IP's en een gebruikslog. De sleutel wordt maar één keer getoond en kan worden gerouleerd of ingetrokken.
120 verzoeken per minuut per sleutel, met een 429-antwoord en de wachttijd als u daarboven komt. Elk bedrijf kan tot 20 actieve sleutels hebben.
Via de route POST /v1/leads van de API, of via de trigger “Webhook ontvangen” van een Workflow, die een eigen adres geeft waarnaar uw systeem, n8n, Make of Zapier de gegevens kunnen sturen. De oude leadwebhook met de sleutel x-api-key bestaat niet meer.
De uitgaande webhooks versturen de gebeurtenissen van e-mailmarketing (geopend, geklikt, geantwoord, uitgeschreven, gebounced, klacht en aan de lijst toegevoegd), ondertekend met HMAC-SHA256 en met nieuwe pogingen. Om uw systeem te waarschuwen voor wijzigingen in de pipeline, de offertes of de bestellingen gebruikt u het blok “Webhook starten” of “HTTP-verzoek” in een Workflow.
De OpenAPI 3.1-specificatie en de Postman-collectie zijn openbaar op api2.astrify.com.br/v1/openapi.json en /v1/postman.json, en het platform heeft een documentatiepagina met authenticatie, scopes, fouten en voorbeelden.
Astrify Flows

AAstrifyin gesprekmetdesysteemvan deuwbedrijf.

Test de Workflows met webhook in het gratis plan en ontgrendel de API vanaf Growth.