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.
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.
| Piano | Al mese | API REST | Ricevi webhook e HTTP nel 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 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.

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
























