שילוב יוצא
אינטגרציה יוצאת:
Whatsapp > CRM והמערכות האחרות שלכם
שתפו מאמר זה עם המפתח שלכם או השתמשו ב-Zapier כדי לשלב את המערכת שלכם עם Whatsapp
ההתקנה
TimelinesAI מאפשר להודיע למערכת חיצונית כאשר הודעה חדשה מתקבלת או נשלחת בכל חשבון WhatsApp מחובר בסביבת עבודה. זה כולל הודעות WhatsApp שנשלחו דרך אפליקציית WhatsApp לנייד או מתוך צירי זמן.
לעתים קרובות נעשה שימוש בשילוב כזה באמצעות שירות מתווך כלשהו כגון Zapier, שבו כל הפעלה של webhook נחשבת לניצול מכסת משימות.
כדי לייעל את השימוש במיכסת משימות, TimelinesAI מספק אפשרות לצבור הודעות מרובות שנשלחו או התקבלו בצ'אט ספציפי במהלך פרק הזמן שנבחר. ההודעות הן דרך webhook כמו "חבילה" אחת. לנוחיותכם, "חבילה" כזו מכילה שדה עם צבירה מעוצבת מראש של הודעות (וקישור לנקודה בשיחות ב- TimelinesAI), אך באפשרותך ליישם עיצוב משלך באמצעות הנתונים שסופקו עם webhook.

כדי להגדיר את השילוב באמצעות Webhooks יוצאים:
- נווט אל תפריט Webhooks בחשבון TimelinesAI שלך
- בחר בכרטיסיה יוצא.
בצוואה יוצגו ההגדרות הבאות:
- גרעיניות צבירה – ההודעות יצטברו ויישלחו באמצעות webhook בהתאם לבחירה (כל 1 / 6 / 12 / 24 שעות) או יישלחו ברגע שהן מופיעות בצירי זמן ("אל תצבור)
- כתובת אתר Webhook – כאן עליך להזין את כתובת האתר בפועל שיש להודיע עליה.
- Webhook מופעל – אתה יכול להשבית את webhook אם אתה רוצה להפסיק את האינטגרציה.
ברגע ש- Webhook הופך לזמין והודעות מסוימות נשלחות, יוצג יומן פעילות (עד 10 הפעולות האחרונות).
הערה: בשלב זה, רק הודעות טקסט ואמוג'י נתמכות. דילוג על הודעות המכילות קבצים מצורפים.
שגיאות ופתרון בעיות
כדי להבטיח פעולה נכונה של האינטגרציה, אם ייתקלו ביותר מ -10 שגיאות רצופות מהקצה המקבל (כל שגיאה, החל מכתובת URL לא חוקית לקוד תגובה שאינו 200), המערכת תשבית את האינטגרציה באופן אוטומטי. במקרה כזה, הבעלים של סביבת העבודה יקבל הודעה בדוא"ל.
במקרה שתצטרך לפתור שגיאה, תוכל להוריד יומן מפורט (הקישור יהיה זמין בתחתית הדף), שבו יופיעו עד 100 בקשות אחרונות עם כל פרטי הנתונים שנשלחו והתגובה שהתקבלה.
תבנית נתונים
הנתונים יישלחו לכתובת URL של Webhook באמצעות בקשת HTTP POST, בפורמט JSON. הנתונים מסופקים בשתי תבניות שונות, בהתאם להגדרת גרעיניות הצבירה, כמתואר להלן.
צבירה כל X שעות
הודעות יצטברו ל"חבילה". הנתונים הבאים יהיו זמינים:
- "חשבון WhatsApp" – פרטי חשבון WhatsApp (ו-Workspace Teammate, שחיבר את החשבון), דרכו התקבלה או נשלחה ההודעה
- "טלפון" – מספר הטלפון של חשבון WA
- "full_name" – שמו המלא של בעל חשבון WA, כפי שנרשם ב-Timelines
- "דוא"ל" – כתובת הדוא"ל של בעל חשבון WA, כפי שנרשם ב-Timelines
- "צ'אט" – פרטי הצ'אט (צ'אט ישיר או קבוצה), בו נשלחה או התקבלה ההודעה
- "full_name" – שם הצ'אט (כפי שמופיע ב-Timelines)
- "responsible_name" – שמו של חבר צוות שהוקצה כאחראי לצ'אט זה
- "responsible_email" – הדוא"ל של חבר צוות שהוקצה כאחראי לצ'אט זה
- "chat_url" – כתובת האתר, שבה ניתן לגשת לצ'אט ב- TimelinesUI
- "chat_id" – מזהה הצ'אט ב- TimelinesUI (ניתן להשתמש בו לבניית כתובת URL של הצ'אט או עם webhooks נכנסים)
- "is_new_chat" – נכון, אם הצ'אט הזה נוצר זה עתה, שקר אחרת
- "is_group" – נכון, אם הצ'אט הזה הוא צ'אט ישיר, שקר אחרת
- "טלפון" – מספר הטלפון של הצ'אט (ריק לצ'אט קבוצתי)
- "הודעות" – רשימת הודעות, כאשר כל אובייקט הודעה מכיל את השדות הבאים
- "כיוון" – ניתן "לקבל" או "לשלוח"
- "חותמת זמן" – חותמת זמן של הודעה, באזור זמן UTC
- "message_id" – מזהה ייחודי פנימי של ההודעה
- "שולח" – פרטי שולח (משתתף בצ'אט) של הודעה
- "full_name" – כותרת הצ'אט או שם חבר הצוות בצירי זמן (אם נשלח מתוך צירי הזמן)
- "טלפון" – מספר הטלפון של השולח (או ריק לצ'אט קבוצתי)
- "נמען" – פרטי שולח (משתתף בצ'אט) של הודעה
- "full_name" – כותרת הצ'אט או שם חבר הצוות ב"צירי זמן"
- "טלפון" – מספר הטלפון של הנמען (או ריק לצ'אט קבוצתי)
- "טקסט" – טקסט הודעה (טקסט רגיל)
- "first_message_timestamp" – חותמת הזמן של ההודעה המוקדמת ביותר בחבילה, באזור הזמן UTC
- "last_message_timestamp" – חותמת הזמן של ההודעה האחרונה בחבילה, באזור הזמן UTC
- "צבירה" – טקסט מצטבר של ההודעה, בפורמט HTML, המתאים לשימוש עם CRM או מערכות דומות כתוכן להערות, כולל קישור ישיר להודעה הראשונה בצירי זמן.
דוגמה
{ "whatsapp_account" : { "full_name" : "Amnon Haha", "email" : "Amnon@acme.com", "phone" : "+972500000000" }, "chat": { "full_name": "John Doe>", "responsible_name": "Amnon", "responsible_email": "Amnon@acme.com", "chat_url" : "https://app.timelines.ai/chat/10010001/messages/", "chat_id" : "10010001", "is_new_chat" : true, "is_group": false, "phone": "+97254000000" }, "messages" : [ { "direction": "sent", "timestamp": "2021-02-24T16:25:29+0000", "message_id": "ddfskhsd76dsfs6dsd5skjsdhf", "sender": { "full_name": "John Doe", "phone": "+972540000000" }, "recipient": { "full_name": "Jane Smith", "phone": "+972550000000" }, "text": "lorem ipsum" }, { "direction": "received", "timestamp": "2021-02-24T16:30:29+0000", "message_id": "ddfskhsd76dsfs6dsd5skjsdhf", "sender": { "full_name": "John Doe", "phone": "+972540000000" }, "recipient": { "full_name": "Jane Smith", "phone": "+972550000000" }, "text": "lorem ipsum" } ], "first_message_timestamp" : "2021-02-24T16:25:29+0000", "last_message_timestamp" : "2021-02-24T16:30:29+0000", "aggregation": "from John Doe on 2021-02-24 16:25: Hi! How are you?<br/>from Jane Smith on 2021-02-24 16:30: I am fine, how are you?<br/>Click <a href='https://app.timelines.ai/permalink/77a28d55-5345-5435-8c72-3a7bcad8ded9/'>here</h> to open the conversation in TimelinesAI" }
אל תצברו
כל הודעה נשלחת בנפרד, ברגע שהיא הופכת לזמינה. לא מתרחש "צרור". הנתונים הבאים יהיו זמינים:
- "חשבון WhatsApp" – פרטי חשבון WhatsApp (ו-Workspace Teammate, שחיבר את החשבון), דרכו התקבלה או נשלחה ההודעה
- "טלפון" – מספר הטלפון של חשבון WA
- "full_name" – שמו המלא של בעל חשבון WA, כפי שנרשם ב-Timelines
- "דוא"ל" – כתובת הדוא"ל של בעל חשבון WA, כפי שנרשם ב-Timelines
- "צ'אט" – פרטי הצ'אט (צ'אט ישיר או קבוצה), בו נשלחה או התקבלה ההודעה
- "full_name" – שם הצ'אט (כפי שמופיע ב-Timelines)
- "responsible_name" – שמו של חבר צוות שהוקצה כאחראי לצ'אט זה
- "responsible_email" – הדוא"ל של חבר צוות שהוקצה כאחראי לצ'אט זה
- "chat_url" – כתובת האתר, שבה ניתן לגשת לצ'אט ב- TimelinesUI
- "chat_id" – מזהה הצ'אט ב- TimelinesUI (ניתן להשתמש בו לבניית כתובת URL של הצ'אט או עם webhooks נכנסים)
- "is_new_chat" – נכון, אם הצ'אט הזה נוצר זה עתה, שקר אחרת
- "is_group" – נכון, אם הצ'אט הזה הוא צ'אט ישיר, שקר אחרת
- "טלפון" – מספר הטלפון של הצ'אט (ריק לצ'אט קבוצתי)
- "הודעה" – פרטי ההודעה
- "כיוון" – ניתן "לקבל" או "לשלוח"
- "חותמת זמן" – חותמת זמן של הודעה, באזור זמן UTC
- "message_id" – מזהה ייחודי פנימי של ההודעה
- "שולח" – פרטי שולח (משתתף בצ'אט) של הודעה
- "full_name" – כותרת הצ'אט או שם חבר הצוות בצירי זמן (אם נשלח מתוך צירי הזמן)
- "טלפון" – מספר הטלפון של השולח (או ריק לצ'אט קבוצתי)
- "נמען" – פרטי שולח (משתתף בצ'אט) של הודעה
- "full_name" – כותרת הצ'אט או שם חבר הצוות ב"צירי זמן"
- "טלפון" – מספר הטלפון של הנמען (או ריק לצ'אט קבוצתי)
- "טקסט" – טקסט הודעה (טקסט רגיל)
דוגמה
{ "whatsapp_account" : { "full_name" : "Amnon Haha", "email" : "Amnon@acme.com", "phone" : "+972500000000" }, "chat": { "full_name": "John Doe>", "responsible_name": "Amnon", "responsible_email": "Amnon@acme.com", "chat_url" : "https://app.timelines.ai/chat/10010001/messages/", "chat_id" : "10010001", "is_new_chat" : true, "is_group": false, "phone": "+97251111111" }, "message" : { "direction": "sent", "timestamp": "2021-02-24T06:25:29+0000", "message_id": "ddfskhsd76dsfs6dsd5skjsdhf", "sender": { "full_name": "John Doe", "phone": "+972540000000" }, "recipient": { "full_name": "Jane Smith", "phone": "+972550000000" }, "text": "lorem ipsum" } }
- שימוש ב-WhatsApp בחינוך: סקירה מקיפה - 28 בנובמבר 2023
- מדריך לגיוס בוואטסאפ: תמונת מצב מקיפה - 27.11.2023
- מדריך האינטגרציה של ActiveCampaign ו-WhatsApp - 24 בנובמבר 2023