Geliştiriciler için
Astrify'ı entegre etmek için REST API ve webhook'lar
Sisteminizden lead'ler oluşturun, mesaj gönderin, panolarda işlem yapın ve Workflow'ları tetikleyin; webhook ile veri alın ve bir akışın ortasında herhangi bir API'yi çağırın; kapsamlı anahtarlar ve OpenAPI dokümantasyonuyla.
- OpenAPI 3.1 ve Postman
- Kapsamlı anahtarlar
- Growth'tan itibaren
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
API'de rotalar, lead'lerden ve mesajlardan panolara ve tekliflere kadar
- 16
anahtar başına okuma veya yazma kapsamlı kaynaklar
- 120
her anahtarda dakikada istek
- 20
şirket başına etkin anahtar, her birinin kendi kullanım kaydıyla
REST API
API ne yapar
Kaynağı seçin ve bazı rotaları görün.
Lead'ler ve pipeline
Lead'leri oluşturun ve güncelleyin, kopyaları birleştirin, toplu içe aktarın ve etkinlik ile not kaydedin. Pipeline ve aşamalar API üzerinden okunur.
- Lead'leri oluştur, listele, güncelle, sil ve birleştir
- Toplu içe aktarma ve kopya arama
- Anlaşmanın etkinlikleri, notları, katılımcıları ve kalemleri
- Pipeline'lar, aşamalar, kaynaklar ve kayıp nedenleri (okuma)
api2.astrify.com.br/v1
- POST/leads
- GET/leads
- PATCH/leads/{lead_id}
- POST/leads/importar-lote
- GET/funis/{funil_id}/etapas
API anahtarları
Her entegrasyon kendi anahtarınızla
Anahtarlar Ayarlar › Açık API'de oluşturulur ve Authorization başlığında gönderilir. Onu oluşturan kişi gibi davranırlar ve o kişi devre dışı bırakılırsa durur.
- 01
Kaynağa göre kapsam
Her anahtar yalnızca işaretlediğinizi okur veya yazar: lead'ler, kişiler, panolar, mesajlar ve gerisi.
- 02
Geçerlilik ve IP'ler
1 ila 730 gün geçerlilik ve en fazla 20 yetkili IP listesi.
- 03
Bir kez gösterilir
Anahtar yalnızca oluşturulurken görünür; Astrify yalnızca imzasını saklar.
- 04
Yenile ve iptal et
Entegrasyonu durdurmadan anahtarı değiştirin ve anında iptal edin; her birinin kullanım kaydıyla.
Gelen webhook
Sisteminiz bildirir, Workflow harekete geçer
“Webhook al” tetikleyicisi Workflow'a kendi adresini verir. Sisteminizin, n8n'in, Make'in veya Zapier'in JSON'unu gönderin, lead'i e-posta veya telefonla bulun ve akışı sürdürün. Dinleme modunda Astrify, açmadan önce alanları eşleyebilmeniz için ilk gönderimi gösterir.
- GET, POST, PUT ve PATCH, en fazla 256 KB
- Gerçek gönderimi görmek için 2 dakikalık dinleme modu
- Her tetikleyicide saklanan son 50 olay
- Her adreste dakikada en fazla 120 çağrı
POST /api/webhooks/workflow/{token}
{
"evento": "pagamento_aprovado",
"cliente": {
"nome": "João Prado",
"email": "joao@pradoalimentos.com.br"
},
"valor": 1290.00
}Astrify'dan sisteminize
Bilmeniz gerekene göre iki yol.
Workflow'da
HTTP isteği ve Webhook tetikle
Herhangi bir tetikleyici (lead aşama değiştirdi, teklif kabul edildi, sipariş teslim edildi) akışın ortasında sisteminizi çağırabilir ve yanıtı sonraki bloklarda kullanabilir.
- Başlıklar ve JSON gövdesiyle GET, POST, PUT, PATCH ve DELETE
- URL'de ve gövdede lead değişkenleri
- Yanıt, Eğer/Değilse için bir değişkende saklanır
- Yanıtı bekle veya tetikle ve ilerle
Giden webhook'lar
E-posta pazarlaması olayları
Ayarlar › Webhook'lar'da en fazla 10 adres kaydedin ve her olayı imzalı, yeniden denemeler ve teslimat geçmişiyle alın.
- email.opened
- email.clicked
- email.replied
- email.unsubscribed
- email.bounced
- email.complaint
- email.list_joined
- X-Astrify-Signature başlığında HMAC-SHA256 imzası
- 1 dk, 5 dk, 30 dk, 2 sa ve 6 sa sonra yeniden denemeler
- Yeniden gönderim ve test düğmeli geçmiş
Dokümantasyon
OpenAPI, Postman ve platformdaki rehber
OpenAPI 3.1 şartnamesi ve Postman koleksiyonu api2.astrify.com.br/v1/openapi.json ve /v1/postman.json adreslerinde açıktır. Platformun içinde dokümantasyon sayfası kimlik doğrulamayı, kapsamları, hataları ve her rotanın örneklerini anlatır.
Planlar
Her planda API
REST API ve anahtarlar Growth'tan itibaren gelir. “Webhook al” tetikleyicisi ve istek blokları, Workflow'ların içinde tüm planlarda bulunur.
| Plan | Aylık | REST API | Workflow'da webhook al ve HTTP |
|---|---|---|---|
| Starter Free | Ücretsiz | — | Evet |
| Lite | R$ 197,90 | — | Evet |
| Growth | R$ 397,90 | Evet | Evet |
| Pro | R$ 797,90 | Evet | Evet |
| Scale | R$ 1.497,90 | Evet | Evet |
Aylık, Brezilya reali (BRL) cinsinden; yıllıkta 10 ay öder, 12 ay kullanırsınız. Tüm planları gör
Buradan devam edin
Sık sorulan sorular
Geliştiricilerin entegrasyondan önce sorduğu sorular.

AAstrifykonuşuyorilebusistem'nınsizinşirket.
Webhook'lu Workflow'ları ücretsiz planda test edin ve API'yi Growth'tan itibaren açın.
























