Astrify FlowsAstrify FlowsMeta Business Partner

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.

Araçlar

ücretli bağlayıcı olmadan n8n, Make ve Zapier

Bu araçların HTTP isteği düğümünü kendi anahtarınızla, onların webhook'unu da “Webhook tetikle” bloğunda kullanın.

  • n8n
  • Make
  • Zapier
Kanal token'ları ve webhook sırları şifreli saklanır, platformdan çıkan isteklerde dahili adresler engellenir ve API, anahtarı oluşturan kişinin rolünün izinlerine saygı gösterir.

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.

PlanAylıkREST APIWorkflow'da webhook al ve HTTP
Starter FreeÜcretsiz—Evet
LiteR$ 197,90—Evet
GrowthR$ 397,90EvetEvet
ProR$ 797,90EvetEvet
ScaleR$ 1.497,90EvetEvet

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.

Evet, Growth'tan itibaren: lead'ler, kişiler, pipeline'lar, etiketler, ürünler, teklifler, WhatsApp mesajları, görüşmeler, Workflow'lar, kampanyalar, e-posta, ekipler, görevler, panolar ve bildirimler için yaklaşık 128 rotalı bir REST API.
Ayarlar › Açık API'de oluşturulan ve Authorization: Bearer başlığında gönderilen bir anahtarla. Her anahtarın kaynak başına kapsamı (okuma veya yazma), 1 ila 730 gün geçerliliği, isteğe bağlı IP listesi ve kullanım kaydı vardır. Yalnızca bir kez görünür ve yenilenebilir veya iptal edilebilir.
Her anahtarda dakikada 120 istek; aşıldığında 429 yanıtı ve bekleme süresi döner. Her şirketin en fazla 20 etkin anahtarı olabilir.
API'nin POST /v1/leads rotasıyla veya sisteminizin, n8n'in, Make'in ya da Zapier'in verileri göndermesi için kendi adresini veren bir Workflow'un “Webhook al” tetikleyicisiyle. x-api-key anahtarlı eski lead webhook'u artık yok.
Giden webhook'lar e-posta pazarlaması olaylarını (açtı, tıkladı, yanıtladı, aboneliği iptal etti, geri döndü, şikayet ve listeye girdi) HMAC-SHA256 imzalı ve yeniden denemelerle gönderir. Sisteminizi pipeline'daki, tekliflerdeki veya siparişlerdeki değişikliklerden haberdar etmek için bir Workflow'da “Webhook tetikle” veya “HTTP isteği” bloğunu kullanın.
OpenAPI 3.1 şartnamesi ve Postman koleksiyonu api2.astrify.com.br/v1/openapi.json ve /v1/postman.json adreslerinde açıktır; platformda kimlik doğrulama, kapsamlar, hatalar ve örnekler içeren bir dokümantasyon sayfası da vardır.
Astrify Flows

AAstrifykonuşuyorilebusistem'nınsizinşirket.

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