Astrify FlowsAstrify FlowsMeta Business Partner

للمطورين

API REST وwebhooks للتكامل مع Astrify

أنشئ عملاء محتملين، وأرسل رسائل، وعدّل اللوحات، وأطلق Workflows من نظامك، واستقبل البيانات عبر webhook، واستدعِ أي API في منتصف التدفق، بمفاتيح حسب النطاق وتوثيق OpenAPI.

  • OpenAPI 3.1 وPostman
  • مفاتيح بنطاق محدد
  • بدءًا من Growth

الطرفية

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، من العملاء المحتملين والرسائل إلى اللوحات والعروض

  • 16

    موردًا بنطاق قراءة أو كتابة لكل مفتاح

  • 120

    طلبًا في الدقيقة لكل مفتاح

  • 20

    مفتاحًا نشطًا لكل شركة، ولكل منها سجل استخدام خاص

API REST

ما تفعله API

اختر المورد وشاهد بعض المسارات.

العملاء المحتملون والمسار

أنشئ العملاء المحتملين وحدّثهم، وادمج المكرّرين، واستورد دفعة واحدة، وسجّل الأنشطة والملاحظات. ويُقرأ المسار والمراحل عبر API.

  • إنشاء العملاء المحتملين وعرضهم وتحديثهم وحذفهم ودمجهم
  • الاستيراد الجماعي والبحث عن المكرّرات
  • الأنشطة والملاحظات والمشاركون وعناصر الصفقة
  • المسارات والمراحل والمصادر وأسباب الخسارة (قراءة)

api2.astrify.com.br/v1

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

مفاتيح API

كل تكامل بمفتاحه الخاص

تُنشأ المفاتيح في الإعدادات › API مفتوحة وتُرسل في ترويسة Authorization. وتعمل بصلاحيات من أنشأها، وتتوقف إذا تم تعطيل ذلك الشخص.

  • 01

    نطاق لكل مورد

    كل مفتاح يقرأ أو يكتب فقط ما تحدده: العملاء المحتملون وجهات الاتصال واللوحات والرسائل وغيرها.

  • 02

    الصلاحية وعناوين IP

    صلاحية من 1 إلى 730 يومًا وقائمة تصل إلى 20 عنوان IP مصرّحًا به.

  • 03

    تظهر مرة واحدة

    يظهر المفتاح عند إنشائه فقط؛ وتحتفظ Astrify ببصمة منه فقط.

  • 04

    تدوير وإلغاء

    بدّل المفتاح دون إيقاف التكامل وألغِه فورًا، مع سجل استخدام لكل مفتاح.

webhook وارد

نظامك ينبّه، وWorkflow ينفّذ

يمنح مشغّل «استقبال webhook» لـ Workflow عنوانًا خاصًا به. أرسل JSON من نظامك أو من n8n أو Make أو Zapier، واعثر على العميل المحتمل عبر البريد الإلكتروني أو الهاتف، وتابع التدفق. وفي وضع الاستماع تعرض Astrify أول عملية إرسال لتربط الحقول قبل التفعيل.

  • GET وPOST وPUT وPATCH، حتى 256 كيلوبايت
  • وضع استماع لمدة دقيقتين لرؤية الإرسال الفعلي
  • آخر 50 حدثًا محفوظة في كل مشغّل
  • حتى 120 استدعاءً في الدقيقة لكل عنوان

POST /api/webhooks/workflow/{token}

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

من Astrify إلى نظامك

مساران، بحسب ما تريد معرفته.

في Workflow

طلب HTTP وإطلاق webhook

يمكن لأي مشغّل (تغيّرت مرحلة العميل المحتمل، قُبل العرض، سُلّم الطلب) استدعاء نظامك في منتصف التدفق واستخدام الرد في الكتل التالية.

  • GET وPOST وPUT وPATCH وDELETE مع ترويسات وجسم JSON
  • متغيّرات العميل المحتمل في URL وفي الجسم
  • الرد محفوظ في متغيّر لاستخدامه في «إذا/وإلا»
  • انتظار الرد أو الإرسال والمتابعة

webhooks صادرة

أحداث التسويق عبر البريد الإلكتروني

سجّل حتى 10 عناوين في الإعدادات › Webhooks واستقبل كل حدث موقّعًا، مع إعادة المحاولة وسجل التسليم.

  • email.opened
  • email.clicked
  • email.replied
  • email.unsubscribed
  • email.bounced
  • email.complaint
  • email.list_joined
  • توقيع HMAC-SHA256 في الترويسة X-Astrify-Signature
  • إعادة المحاولة بعد دقيقة و5 دقائق و30 دقيقة وساعتين و6 ساعات
  • سجل مع إعادة الإرسال وزر اختبار

التوثيق

OpenAPI وPostman والدليل داخل المنصة

مواصفة OpenAPI 3.1 ومجموعة Postman متاحتان للجميع على api2.astrify.com.br/v1/openapi.json و/v1/postman.json. وداخل المنصة تشرح صفحة التوثيق المصادقة والنطاقات والأخطاء وأمثلة كل مسار.

الأدوات

n8n وMake وZapier دون موصّل مدفوع

استخدم عقدة طلب HTTP في هذه الأدوات بمفتاحك، وwebhook الخاص بها في كتلة «إطلاق webhook».

  • n8n
  • Make
  • Zapier
رموز القنوات المميّزة (tokens) وأسرار webhooks تُحفظ مشفّرة، وتُحظر العناوين الداخلية في الطلبات الصادرة من المنصة، وتحترم API صلاحيات دور من أنشأ المفتاح.

الخطط

API في كل خطة

واجهة API REST والمفاتيح متاحة بدءًا من خطة Growth. أما مشغّل «استقبال webhook» وكتل الطلبات فهي متاحة في جميع الخطط ضمن Workflows.

الخطةشهريًاAPI RESTاستقبال webhook وHTTP في Workflow
Starter Freeمجاني—نعم
LiteR$ 197,90—نعم
GrowthR$ 397,90نعمنعم
ProR$ 797,90نعمنعم
ScaleR$ 1.497,90نعمنعم

شهريًا، بالريال البرازيلي (BRL)؛ وفي الاشتراك السنوي تدفع 10 أشهر وتستخدم 12. عرض جميع الخطط

تابع من هنا

الأسئلة الشائعة

ما يسأل عنه المطورون قبل التكامل.

نعم، بدءًا من Growth: API REST بنحو 128 مسارًا للعملاء المحتملين وجهات الاتصال والمسارات والوسوم والمنتجات والعروض ورسائل واتساب والمحادثات وWorkflows والحملات والبريد الإلكتروني والفرق والمهام واللوحات والإشعارات.
بمفتاح يُنشأ في الإعدادات › API مفتوحة ويُرسل في الترويسة Authorization: Bearer. لكل مفتاح نطاق حسب المورد (قراءة أو كتابة)، وصلاحية من 1 إلى 730 يومًا، وقائمة اختيارية بعناوين IP وسجل استخدام. ويظهر مرة واحدة فقط ويمكن تدويره أو إلغاؤه.
120 طلبًا في الدقيقة لكل مفتاح، مع الرد بالرمز 429 ومدة الانتظار عند تجاوز ذلك. يمكن لكل شركة امتلاك ما يصل إلى 20 مفتاحًا نشطًا.
عبر مسار POST /v1/leads في API، أو عبر مشغّل «استقبال webhook» في Workflow، الذي يمنح عنوانًا خاصًا ليرسل نظامك أو n8n أو Make أو Zapier البيانات. أما webhook العملاء المحتملين القديم بمفتاح x-api-key فلم يعد موجودًا.
ترسل webhooks الصادرة أحداث التسويق عبر البريد الإلكتروني (فتح، نقر، رد، إلغاء اشتراك، ارتداد، شكوى، انضمام إلى قائمة)، موقّعة بـ HMAC-SHA256 مع إعادة المحاولة. ولتنبيه نظامك بالتغييرات في المسار أو العروض أو الطلبات، استخدم كتلة «إطلاق webhook» أو «طلب HTTP» في Workflow.
مواصفة OpenAPI 3.1 ومجموعة Postman متاحتان للجميع على api2.astrify.com.br/v1/openapi.json و/v1/postman.json، وللمنصة صفحة توثيق تشرح المصادقة والنطاقات والأخطاء مع أمثلة.
Astrify Flows

AAstrifyقيد المحادثةمعالالنظاممنالخاصة بكالشركة.

جرّب Workflows مع webhook في الخطة المجانية، وفعّل API بدءًا من Growth.