Astrify FlowsAstrify FlowsMeta Business Partner

Per sviluppatori

API REST e webhook per integrare Astrify

Crei lead, invii messaggi, gestisca i board e avvii Workflow dal Suo sistema, riceva dati tramite webhook e chiami qualsiasi API nel mezzo di un flusso, con chiavi per scope e documentazione OpenAPI.

  • OpenAPI 3.1 e Postman
  • Chiavi con scope
  • Dal piano Growth

Terminale

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

    route nell'API, da lead e messaggi a board e proposte

  • 16

    risorse con scope di lettura o scrittura per chiave

  • 120

    richieste al minuto per ogni chiave

  • 20

    chiavi attive per azienda, ciascuna con il proprio registro di utilizzo

API REST

Cosa fa l'API

Scelga la risorsa e veda alcune route.

Lead e pipeline

Crei e aggiorni lead, unisca i duplicati, importi in blocco e registri attività e note. La pipeline e le fasi vengono lette tramite l'API.

  • Creare, elencare, aggiornare, eliminare e unire lead
  • Importazione in blocco e ricerca di duplicati
  • Attività, note, partecipanti ed elementi del deal
  • Pipeline, fasi, origini e motivi di perdita (lettura)

api2.astrify.com.br/v1

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

Chiavi API

Ogni integrazione con la sua chiave

Le chiavi si creano in Impostazioni › API aperta e si inviano nell'header Authorization. Agiscono come l'utente che le ha create e smettono di funzionare se quella persona viene disattivata.

  • 01

    Scope per risorsa

    Ogni chiave legge o scrive solo ciò che Lei seleziona: lead, contatti, board, messaggi e il resto.

  • 02

    Validità e IP

    Validità da 1 a 730 giorni e lista di fino a 20 IP autorizzati.

  • 03

    Mostrata una sola volta

    La chiave viene mostrata solo al momento della creazione; Astrify ne conserva soltanto una firma.

  • 04

    Ruotare e revocare

    Sostituisca la chiave senza fermare l'integrazione e la revochi subito, con il registro di utilizzo di ciascuna.

Webhook in ingresso

Il Suo sistema avvisa, il Workflow agisce

Il trigger “Ricevi webhook” assegna al Workflow un indirizzo proprio. Invii il JSON dal Suo sistema, da n8n, Make o Zapier, trovi il lead tramite e-mail o telefono e prosegua con il flusso. In modalità ascolto, Astrify mostra il primo invio così può mappare i campi prima di attivare.

  • GET, POST, PUT e PATCH, fino a 256 KB
  • Modalità ascolto di 2 minuti per vedere l'invio reale
  • Ultimi 50 eventi salvati per ogni trigger
  • Fino a 120 chiamate al minuto per ogni indirizzo

POST /api/webhooks/workflow/{token}

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

Da Astrify al Suo sistema

Due percorsi, in base a ciò che Le serve sapere.

Nel Workflow

Richiesta HTTP e Invia webhook

Qualsiasi trigger (lead cambiato di fase, proposta accettata, ordine consegnato) può chiamare il Suo sistema nel mezzo del flusso e usare la risposta nei blocchi successivi.

  • GET, POST, PUT, PATCH e DELETE con header e corpo JSON
  • Variabili del lead nell'URL e nel corpo
  • Risposta salvata in una variabile per il Se/Altrimenti
  • Attendere la risposta oppure inviare e proseguire

Webhook in uscita

Eventi dell'e-mail marketing

Registri fino a 10 indirizzi in Impostazioni › Webhook e riceva ogni evento firmato, con nuovi tentativi e lo storico delle consegne.

  • email.opened
  • email.clicked
  • email.replied
  • email.unsubscribed
  • email.bounced
  • email.complaint
  • email.list_joined
  • Firma HMAC-SHA256 nell'header X-Astrify-Signature
  • Nuovi tentativi dopo 1 min, 5 min, 30 min, 2 h e 6 h
  • Storico con reinvio e pulsante di test

Documentazione

OpenAPI, Postman e la guida nella piattaforma

La specifica OpenAPI 3.1 e la collection di Postman sono pubbliche su api2.astrify.com.br/v1/openapi.json e /v1/postman.json. All'interno della piattaforma, la pagina di documentazione spiega autenticazione, scope, errori ed esempi di ogni route.

Strumenti

n8n, Make e Zapier senza connettore a pagamento

Usi il nodo di richiesta HTTP di questi strumenti con la Sua chiave, e il loro webhook nel blocco “Invia webhook”.

  • n8n
  • Make
  • Zapier
I token dei canali e i segreti dei webhook sono crittografati, gli indirizzi interni sono bloccati nelle richieste in uscita dalla piattaforma e l'API rispetta i permessi del ruolo di chi ha creato la chiave.

Piani

API in ogni piano

L'API REST e le chiavi sono disponibili dal piano Growth. Il trigger “Ricevi webhook” e i blocchi di richiesta sono presenti in tutti i piani, all'interno dei Workflow.

PianoAl meseAPI RESTRicevi webhook e HTTP nel Workflow
Starter FreeGratis—Sì
LiteR$ 197,90—Sì
GrowthR$ 397,90SìSì
ProR$ 797,90SìSì
ScaleR$ 1.497,90SìSì

Al mese, in reais brasiliani (BRL); con il piano annuale paga 10 mesi e ne usa 12. Vedi tutti i piani

Continui da qui

Domande frequenti

Cosa chiedono gli sviluppatori prima di integrare.

Sì, dal piano Growth: un'API REST con circa 128 route per lead, contatti, pipeline, tag, prodotti, proposte, messaggi WhatsApp, conversazioni, Workflow, campagne, e-mail, team, attività, board e notifiche.
Con una chiave creata in Impostazioni › API aperta, inviata nell'header Authorization: Bearer. Ogni chiave ha uno scope per risorsa (lettura o scrittura), validità da 1 a 730 giorni, elenco facoltativo di IP e registro di utilizzo. Viene mostrata una sola volta e può essere ruotata o revocata.
120 richieste al minuto per ogni chiave, con risposta 429 e tempo di attesa quando si supera il limite. Ogni azienda può avere fino a 20 chiavi attive.
Tramite la route POST /v1/leads dell'API, o tramite il trigger “Ricevi webhook” di un Workflow, che fornisce un indirizzo proprio al quale il Suo sistema, n8n, Make o Zapier possono inviare i dati. Il vecchio webhook di lead con chiave x-api-key non esiste più.
I webhook in uscita inviano gli eventi dell'e-mail marketing (aperta, cliccata, risposta, iscrizione annullata, rimbalzata, segnalazione e ingresso nella lista), firmati con HMAC-SHA256 e con nuovi tentativi. Per avvisare il Suo sistema di cambiamenti nella pipeline, nelle proposte o negli ordini, usi il blocco “Invia webhook” o “Richiesta HTTP” in un Workflow.
La specifica OpenAPI 3.1 e la collection di Postman sono pubbliche su api2.astrify.com.br/v1/openapi.json e /v1/postman.json, e la piattaforma dispone di una pagina di documentazione con autenticazione, scope, errori ed esempi.
Astrify Flows

AAstrifyin conversazioneconilsistemadellaSuaazienda.

Provi i Workflow con webhook nel piano gratuito e sblocchi l'API dal piano Growth.