การรวม Webhook ขาเข้า

สร้างเมื่อ

TimelinesAI ช่วยให้คุณสามารถส่งข้อความ WhatsApp โดยอัตโนมัติเพื่อตอบสนองต่อเหตุการณ์หรือการดําเนินการในเครื่องมือที่คุณใช้อยู่แล้ว: CRM, Support, Recruitment systems เป็นต้น

เหตุการณ์ "ส่งข้อความ"

เป็นไปได้ที่จะสั่งให้ TimelinesAI ส่งข้อความ (มีหรือไม่มีไฟล์แนบ) ไปยังผู้ติดต่อเฉพาะ (สามารถเป็นกลุ่มได้) หากมีการเชื่อมต่อบัญชี WhatsApp หลายบัญชีในพื้นที่ทํางานของคุณคุณยังสามารถระบุบัญชี WhatsApp เฉพาะที่จะใช้สําหรับการส่งข้อความได้

ในการตั้งค่าการรวมเจ้าของพื้นที่ทํางานควรไปที่หน้าจอ "Integrations / Inbound Webhooks" และสร้าง URL ใหม่ ระบบภายนอกควรโพสต์ข้อความในรูปแบบเฉพาะ (ดูรายละเอียดด้านล่าง) ไปยัง URL นั้น

ขีด จำกัด

  • ขนาดไฟล์แนบสูงสุดคือ 2 MB
  • ไม่มีการตรวจสอบรูปแบบหมายเลขโทรศัพท์ของผู้รับหรือการเชื่อมต่อกับ WhatsApp ในทันที ไปที่ UI ของไทม์ไลน์เพื่อตรวจสอบสถานะการส่ง/อ่านข้อความ

การส่งไฟล์ผ่าน Webhooks ขาเข้า

การส่งไฟล์: ดาวน์โหลดโดยตรงเทียบกับบริการโฮสต์ไฟล์

จําเป็นต้อง ส่งไฟล์โดยใช้ลิงก์ดาวน์โหลดโดยตรง สิ่งนี้ช่วยให้ผู้รับสามารถรับไฟล์ได้จริง

ในขณะที่ควรใช้บริการโฮสต์ไฟล์เพื่อให้สามารถจัดหาลิงก์ดาวน์โหลดโดยตรงได้ ลิงก์ดังกล่าวได้รับการทดสอบที่ดีที่สุดผ่านการเรียกดูแบบไม่ระบุตัวตน/ส่วนตัว โดยการวางลิงก์ในแถบค้นหา หากการดาวน์โหลดไฟล์เริ่มต้นทันทีลิงก์ จะเป็นที่ยอมรับ หากหน้าเว็บประเภทใด ๆ ปรากฏขึ้นแทนลิงก์จะไม่สามารถใช้สําหรับการส่งไฟล์ได้

กรณีของลิงก์ File Hosting Service คือไม่สามารถดาวน์โหลดไฟล์ได้ สิ่งที่ดาวน์โหลดและส่งแทนคือหน้าเว็บที่ใช้ร่วมกันซึ่งอาจนําไปสู่ไฟล์ที่ "เสียหาย"

ในทางกลับกันจะส่งผลต่อข้อความของคุณเนื่องจากผู้รับไม่สามารถเข้าถึงสื่อที่คุณส่งทําให้ไฟล์ไม่สามารถใช้งานได้ ดังนั้นจึง เป็นเรื่องสําคัญที่คุณจะต้องแน่ใจว่าคุณกําลังส่งลิงก์ดาวน์โหลดโดยตรงเนื่องจากจะช่วยให้พวกเขาเข้าถึงไฟล์ได้โดยไม่มีปัญหาใด ๆ

คุณยังสามารถเรียกใช้การทดสอบนี้โดยการส่งข้อความ Webhook ไปยังหมายเลขทดสอบของคุณ คุณจะสามารถกําหนดได้ว่าไฟล์จะทํางานอย่างไรตามสิ่งที่เราได้ตรวจสอบไว้ที่นี่ หากคุณได้รับข้อความแสดงข้อผิดพลาดเช่น "ไฟล์เสียหาย", "ไฟล์เข้ากันไม่ได้"; หรือ "ไม่สามารถโหลดเอกสาร X" หลังจากคลิกที่ไฟล์แนบนี่คือลิงก์บริการโฮสต์ไฟล์และต้องแทนที่ด้วยลิงก์ดาวน์โหลดโดยตรง

การใช้วงเงิน

  • การส่งข้อความใช้ 1 เครดิตจากโควต้าการส่งข้อความ
  • การส่งข้อความที่มีข้อความและไฟล์แนบที่ไม่ว่างเปล่าจะใช้ 2 เครดิตจากโควต้าการส่งข้อความ
  • หากไม่สามารถส่งข้อความได้ (ไม่ถูกต้องหรือไม่ได้เชื่อมต่อกับหมายเลข WhatsApp ข้อผิดพลาดของเซิร์ฟเวอร์ WhatsApp) โควต้าการส่งข้อความจะถูกกู้คืน (โดยปกติภายในสองสามชั่วโมง)

อัตราการส่งข้อความ

  • ข้อความจะถูกส่งโดยหน่วงเวลาแบบสุ่มประมาณ 2 วินาทีระหว่างแต่ละข้อความ (เพื่อหลีกเลี่ยงกลไกการตรวจจับสแปม WhatsApp)
  • หากคุณเปิดใช้งาน Webhooks ด้วยความถี่น้อยกว่า 2 วินาที ข้อความจะถูกจัดคิวและส่งออกล่าช้า แต่ละข้อความที่ถูกจัดคิวจะใช้เครดิตการส่งข้อความ ดังนั้นจํานวนข้อความที่ถูกจัดคิวจะต้องไม่เกินโควต้าที่มีอยู่

การกําหนดค่าและการดําเนินการของ Webhook

  • " เปิดใช้งาน Webhook" - อนุญาตให้ปิดใช้งาน Webhook โดยไม่ต้องลบออกทั้งหมด
  • "สร้าง URL ใหม่" - จะสร้าง URL ที่ไม่ซ้ํากันใหม่ซึ่งจะยอมรับการแจ้งเตือน URL ก่อนหน้าจะไม่สามารถใช้งานได้อีกต่อไป
  • "ความพยายามในการส่งครั้งล่าสุด" – สถานะของความพยายามในการเปิดใช้งาน Webhook ครั้งล่าสุด
  • "บันทึกการดาวน์โหลด" - บันทึกโดยละเอียดของความพยายามในการเปิดใช้งานครั้งล่าสุด 100 ครั้งซึ่งเป็นประโยชน์ในการแก้ไขปัญหาการจัดรูปแบบ

รูปแบบคําขอ Webhook

Webhook ยอมรับข้อมูลในรูปแบบ JSON โดยใช้คําขอ POST

  • "การดําเนินการ" (จําเป็น) – ปัจจุบันรองรับ "ส่ง" เพียงค่าเดียวเท่านั้น
  • "ข้อความ" (จําเป็น) - ข้อความธรรมดาที่เข้ารหัส UTF-8 ที่จะส่ง (ไม่รองรับ markdown ยกเว้นตัวคั่นบรรทัด "\n") สามารถเว้นว่างไว้ได้หากระบุไฟล์
  • "file_url" (ไม่บังคับ) – URL ที่เข้าถึงได้แบบสาธารณะของไฟล์ที่จะดาวน์โหลดและส่งเป็นไฟล์แนบ
  • "file_name" (ไม่บังคับ) – ชื่อไฟล์แนบ (ต้องระบุหากมีการระบุ URL)

ผู้รับสามารถระบุได้โดยระบุพารามิเตอร์ ใดพารามิเตอร์หนึ่ง ต่อไปนี้:

  • "chat_id" – รหัสของการแชทตามที่ปรากฏใน TimelinesAI (สามารถพบได้ใน URL ของหน้าแชทหรือในเพย์โหลดของ Webhook ขาออก) สิ่งนี้รองรับการส่งข้อความไปยังกลุ่ม
  • " jid" - WhatsApp JID ที่ระบุผู้ติดต่อหรือกลุ่ม
  • "โทรศัพท์" – หมายเลขโทรศัพท์ที่จัดรูปแบบตามมาตรฐานหมายเลขโทรศัพท์ระหว่างประเทศ เช่น
    [+] [รหัสประเทศ] [รหัสพื้นที่] [หมายเลขโทรศัพท์ท้องถิ่น] (ตัวอย่างเช่น +14151231234)
  • "chat_name" – ชื่อที่แน่นอนของการแชทตามที่ปรากฏใน TimelinesAI

หากมีการเชื่อมต่อบัญชี WhatsApp หลายบัญชีในพื้นที่ทํางาน ให้ใช้พารามิเตอร์เพิ่มเติมต่อไปนี้เพื่อระบุบัญชี WhatsApp ที่จะใช้:

  • " โทรศัพท์บัญชี WhatsApp" (ไม่บังคับ) - ระบุ (เป็นหมายเลขโทรศัพท์ในรูปแบบสากล) บัญชี WhatsApp ให้เราเพื่อส่ง หากละไว้ บัญชี WhatsApp ที่ใช้งานอยู่ล่าสุดในพื้นที่ทํางานจะถูกใช้สําหรับการส่ง หมายเหตุ: หากมีการระบุพารามิเตอร์" chat_id" " โทรศัพท์บัญชี whatsapp" จะถูกเพิกเฉยเนื่องจากการแชทแต่ละครั้งเชื่อมต่อกับบัญชี WhatsApp เฉพาะแล้ว

การตอบสนอง Webhook

ในกรณีที่สําเร็จ (คําขอได้รับการตรวจสอบและยอมรับสําหรับการส่ง) Webhook จะตอบกลับด้วยสถานะ HTTP 200 และ JSON ซึ่งมีข้อความที่สร้างขึ้น message_id ข้อความ:

{
    "status": "success",
    "data": {
        "message_id": "wa_backend:3EB09FCC85FE99662E46"
    }
}

 

ในกรณีที่เกิดข้อผิดพลาด Webhook จะตอบสนองด้วยสถานะ HTTP 40X และ JSON พร้อมรายละเอียดของข้อผิดพลาดเช่น:

{
"status": 40X,
"data": {},
"message": "Webhook not found"
}

ตัว อย่าง เช่น

ตัวอย่างที่ 1 - การส่งข้อความผ่านบัญชี WA เฉพาะไปยังหมายเลขโทรศัพท์เฉพาะ:

{
"action": "send",
"whatsapp account phone" : "+15105566777", 
"phone": "+14151231234", 
"text": "lorem ipsum"
}

ตัวอย่างที่ 2 – การส่งข้อความพร้อมข้อความและไฟล์แนบไปยังแชท (หรือกลุ่ม) ที่ระบุโดย id:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://timelines.ai/logo.png",
"file_name" : "logo.png"
}
ผู้ดูแลระบบ
กระทู้ล่าสุดโดย admin (ดูทั้งหมด)
สารบัญ