שילוב Webhook נכנס

TimelinesAI מאפשר לכם לבצע אוטומציה של שליחת הודעות WhatsApp בתגובה לאירועים או פעולות בכלים שאתם כבר משתמשים בהם: CRM, תמיכה, מערכות גיוס וכו'.

אירוע "שלח הודעה"

ניתן להורות TimelinesAI לשלוח הודעה (עם או בלי קובץ מצורף) לאיש קשר ספציפי (יכול להיות קבוצה). אם מחוברים מספר חשבונות WhatsApp בסביבת העבודה שלכם, ניתן גם לציין חשבון WhatsApp מסוים שישמש לשליחת ההודעה.

על מנת להגדיר את האינטגרציה, בעל סביבת עבודה צריך לנווט למסך "אינטגרציות / Webhooks נכנסים" וליצור כתובת URL חדשה. המערכת החיצונית צריכה לפרסם הודעה בפורמט ספציפי (ראה פרטים להלן) בכתובת URL זו.

מגבלות

  • גודל הקובץ המצורף המרבי הוא 2 MB.
  • אין אימות מיידי של פורמט מספר הטלפון של הנמען או החיבור שלו ל-WhatsApp. נווט אל ממשק המשתמש של צירי זמן כדי לאמת את מצב השליחה / הקריאה של הודעות.

שליחת קבצים באמצעות Webhooks נכנסים

שליחת קובץ: הורדה ישירה לעומת שירותי אירוח קבצים

חובה לשלוח קבצים באמצעות קישורי הורדה ישירה. פעולה זו מאפשרת לנמען לקבל בפועל את הקובץ.

בעוד שירות אירוח קבצים צריך לשמש כך שהוא יכול לספק קישור להורדה ישירה. קישור כזה נבדק בצורה הטובה ביותר באמצעות גלישה בסתר / פרטי; על-ידי הדבקת הקישור בסרגל החיפוש. אם הורדת הקובץ מתחילה מיד, הקישור קביל. אם במקום זאת, מוצג כל סוג של דף אינטרנט, לא ניתן להשתמש בקישור לשליחת קבצים.

המקרה עם קישורים לשירות אירוח קבצים הוא שלא ניתן להוריד קבצים. מה שמורידים ושולחים במקום זאת, הוא דף אינטרנט של שיתוף, שעלול להוביל לקובץ "פגום".

פעולה זו, בתורה, תשפיע על ההודעה שלך מכיוון שהנמענים אינם יכולים לגשת למדיה שאתה שולח להם, מה שהופך את הקבצים לבלתי שמישים. לכן, חשוב שתוודא שאתה שולח קישורי הורדה ישירים, מכיוון שזה יאפשר להם לגשת לקובץ ללא בעיות.

אתה יכול גם להפעיל בדיקה זו על ידי שליחת הודעת webhook לאחד ממספרי הבדיקה שלך. תוכל לקבוע כיצד הקובץ יתנהג בהתבסס על מה שבדקנו כאן; אם אתה מקבל הודעת שגיאה כגון "הקובץ פגום", "קובץ לא תואם"; או "נכשל לטעון מסמך X", לאחר לחיצה על הקובץ המצורף, אז זה קישור שירות אירוח קבצים ויש להחליף עם קישור להורדה ישירה.

ניצול אשראי

  • שליחת הודעה צורכת זיכוי אחד ממכסת שליחת ההודעה.
  • שליחת הודעה עם טקסט וקובץ מצורף שאינם ריקים צורכת 2 קרדיטים ממיכסת שליחת ההודעה.
  • אם לא ניתן לשלוח הודעה (לא חוקי או לא מחובר למספר WhatsApp, שגיאת שרת WhatsApp), מכסת שליחת ההודעות תשוחזר (בדרך כלל תוך מספר שעות).

קצב שליחת הודעות

  • ההודעות יישלחו בהשהיה אקראית של כ-2 שניות בין כל שתי הודעות (כדי להימנע ממנגנוני זיהוי דואר זבל בוואטסאפ).
  • אם תפעיל webhooks בתדירות של פחות מ- 2 שניות, הודעות יעמדו בתור ויישלחו עם עיכוב. כל הודעה בתור תצרוך הודעה השולחת קרדיט, כך שמספר ההודעות בתור לא יעלה על המכסה הזמינה.

תצורה ופעולות של Webhook

  • "Webhook מופעל" – מאפשר להשבית את webhook מבלי להסיר אותו לחלוטין
  • "צור כתובת URL חדשה" – תיצור כתובת URL ייחודית חדשה, שתקבל התראות. כתובת URL קודמת לא תהיה זמינה עוד.
  • "ניסיונות שליחה אחרונים" – מצב ניסיונות ההפעלה האחרונים של Webhook
  • "יומן הורדות" – יומן מפורט של 100 ניסיונות הפעלה אחרונים, המסייע לפתרון בעיות עיצוב.

תבנית בקשת Webhook

Webhook מקבל נתונים בפורמט JSON, באמצעות בקשת POST.

  • "פעולה" (חובה) – נכון לעכשיו, רק ערך אפשרי אחד "לשלוח" נתמך
  • "text" (חובה)- הודעה מקודדת UTF-8 בטקסט רגיל שיש לשלוח (אין תמיכה בסימון, למעט מפריד שורות "\n"), ניתן להשאיר ריקה, אם צוין הקובץ.
  • "file_url" (אופציונלי) – כתובת URL נגישה לציבור של קובץ שיורד ויישלח כקובץ מצורף.
  • "file_name" (אופציונלי) – שם לקובץ המצורף (יש לספק, אם צוינה כתובת URL).

ניתן לציין את הנמען על ידי מתן אחד מהפרמטרים הבאים:

  • "chat_id" – מזהה של הצ'אט כפי שמופיע ב- TimelinesAI (ניתן למצוא בכתובת האתר של דף הצ'אט, או במטען של webhook יוצא). פעולה זו תומכת בשליחת הודעות לקבוצה.
  • "jid" – JID WhatsApp המציין איש קשר או קבוצה
  • "טלפון" – מספר טלפון, המעוצב על פי תקן מספרי טלפון בינלאומי, דהיינו:
    [+] [קידומת מדינה] [אזור חיוג] [מספר טלפון מקומי] (לדוגמה: +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 – שליחת הודעה עם טקסט וקובץ מצורף לצ'אט (או לקבוצה) שצוינו במזהה:

{
"action": "send", 
"chat_id": "77234", 
"text": "lorem ipsum"
"file_url" : "https://timelines.ai/logo.png",
"file_name" : "logo.png"
}
תוכן עניינים