Astrify FlowsAstrify FlowsMeta Business Partner

สำหรับนักพัฒนา

API REST และ webhook สำหรับเชื่อมต่อ Astrify

สร้างลีด ส่งข้อความ จัดการบอร์ด และเริ่ม Workflow จากระบบของคุณ รับข้อมูลผ่าน 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 ทำอะไรได้บ้าง

เลือกทรัพยากรและดูตัวอย่างเส้นทาง

ลีดและ pipeline

สร้างและอัปเดตลีด รวมรายการซ้ำ นำเข้าเป็นชุด และบันทึกกิจกรรมและโน้ต API อ่าน pipeline และสเตจได้

  • สร้าง แสดงรายการ อัปเดต ลบ และรวมลีด
  • นำเข้าเป็นชุดและค้นหารายการซ้ำ
  • กิจกรรม โน้ต ผู้เข้าร่วม และรายการสินค้าของดีล
  • pipeline สเตจ แหล่งที่มา และเหตุผลที่เสียลูกค้า (อ่านอย่างเดียว)

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 วัน และรายการ IP ที่ได้รับอนุญาตสูงสุด 20 รายการ

  • 03

    แสดงครั้งเดียว

    คีย์จะแสดงเฉพาะตอนสร้าง Astrify เก็บเพียงลายเซ็นของคีย์เท่านั้น

  • 04

    หมุนเวียนและเพิกถอน

    เปลี่ยนคีย์โดยไม่ต้องหยุดการเชื่อมต่อ และเพิกถอนได้ทันที พร้อมบันทึกการใช้งานของแต่ละคีย์

webhook ขาเข้า

ระบบของคุณแจ้ง แล้ว Workflow ลงมือทำ

ทริกเกอร์ “รับ webhook” ให้ Workflow มีที่อยู่เป็นของตัวเอง ส่ง JSON จากระบบของคุณ n8n Make หรือ Zapier ค้นหาลีดด้วยอีเมลหรือเบอร์โทร แล้วดำเนินโฟลว์ต่อ ในโหมดรอรับ Astrify จะแสดงข้อมูลที่ส่งมาครั้งแรกเพื่อให้คุณจับคู่ฟิลด์ก่อนเปิดใช้งาน

  • GET, POST, PUT และ PATCH สูงสุด 256 KB
  • โหมดรอรับ 2 นาทีเพื่อดูข้อมูลที่ส่งมาจริง
  • เก็บ 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 พร้อมเฮดเดอร์และ body แบบ JSON
  • ตัวแปรของลีดใน URL และ body
  • บันทึกคำตอบในตัวแปรเพื่อใช้กับ ถ้า/มิฉะนั้น
  • รอคำตอบ หรือส่งแล้วไปต่อ

webhook ขาออก

อีเวนต์ของอีเมลมาร์เก็ตติง

ลงทะเบียนได้สูงสุด 10 ที่อยู่ใน การตั้งค่า › Webhooks และรับทุกอีเวนต์พร้อมลายเซ็น มีการลองส่งใหม่และประวัติการส่ง

  • email.opened
  • email.clicked
  • email.replied
  • email.unsubscribed
  • email.bounced
  • email.complaint
  • email.list_joined
  • ลายเซ็น HMAC-SHA256 ในเฮดเดอร์ X-Astrify-Signature
  • ลองส่งใหม่ที่ 1 นาที 5 นาที 30 นาที 2 ชม. และ 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
โทเค็นของช่องทางและรหัสลับของ webhook ถูกเข้ารหัส ที่อยู่ภายในถูกบล็อกในคำขอที่ออกจากแพลตฟอร์ม และ API เคารพสิทธิ์ตามตำแหน่งของผู้สร้างคีย์

แพ็กเกจ

API ในแต่ละแพ็กเกจ

API REST และคีย์ใช้ได้ตั้งแต่แพ็กเกจ Growth ขึ้นไป ส่วนทริกเกอร์ “รับ webhook” และบล็อกคำขอมีในทุกแพ็กเกจ ภายใน Workflow

แพ็กเกจต่อเดือน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 เส้นทาง สำหรับลีด ผู้ติดต่อ pipeline แท็ก สินค้า ใบเสนอราคา ข้อความ WhatsApp การสนทนา Workflow แคมเปญ อีเมล ทีม งาน บอร์ด และการแจ้งเตือน
ด้วยคีย์ที่สร้างใน การตั้งค่า › API แบบเปิด ส่งในเฮดเดอร์ Authorization: Bearer แต่ละคีย์มีสโคปตามทรัพยากร (อ่านหรือเขียน) อายุ 1 ถึง 730 วัน รายการ IP ที่เลือกกำหนดได้ และบันทึกการใช้งาน คีย์แสดงเพียงครั้งเดียวและหมุนเวียนหรือเพิกถอนได้
120 คำขอต่อนาทีต่อคีย์ หากเกินจะตอบกลับ 429 พร้อมเวลารอ แต่ละบริษัทมีคีย์ที่ใช้งานได้สูงสุด 20 คีย์
ผ่านเส้นทาง POST /v1/leads ของ API หรือผ่านทริกเกอร์ “รับ webhook” ของ Workflow ซึ่งให้ที่อยู่เฉพาะสำหรับให้ระบบของคุณ n8n Make หรือ Zapier ส่งข้อมูลมา webhook ลีดแบบเดิมที่ใช้คีย์ x-api-key ไม่มีแล้ว
webhook ขาออกส่งอีเวนต์ของอีเมลมาร์เก็ตติง (เปิดอ่าน คลิก ตอบกลับ ยกเลิกการรับ ตีกลับ ร้องเรียน และเข้าสู่รายการ) พร้อมลายเซ็น HMAC-SHA256 และมีการลองส่งใหม่ หากต้องการแจ้งระบบของคุณเมื่อ pipeline ใบเสนอราคา หรือคำสั่งซื้อมีการเปลี่ยนแปลง ให้ใช้บล็อก “ส่ง webhook” หรือ “คำขอ HTTP” ใน Workflow
สเปก OpenAPI 3.1 และคอลเลกชัน Postman เปิดให้ใช้ที่ api2.astrify.com.br/v1/openapi.json และ /v1/postman.json และแพลตฟอร์มมีหน้าเอกสารที่อธิบายการยืนยันตัวตน สโคป ข้อผิดพลาด และตัวอย่าง
Astrify Flows

AAstrifyกำลังสนทนาพร้อมที่ระบบของของคุณบริษัท

ทดสอบ Workflow ด้วย webhook ในแพ็กเกจฟรี และปลดล็อก API ตั้งแต่ Growth ขึ้นไป