सर्व मार्गदर्शक

खाते आणि जोडण्या

बाह्य प्रणाली किंवा सहाय्यक जोडा

Pro किंवा Agency मध्ये मर्यादित व्याप्तीची कळ तयार करा, नवीन आशय प्रकाशित करा किंवा सहाय्यक जोडा.

सुरू करण्यापूर्वी

Webhook म्हणजे WhatsApp कडील येणाऱ्या संदेशांची सूचना घेणारा पत्ता. सर्व्हर सेटअप संचालक करतो; वापरकर्त्याने बदलायचा नाही. MCP सहाय्यक साधने मागू देते.

काय करावे

  1. येणाऱ्या घटनांसाठी सेटिंग्जमध्ये Webhook URL (WhatsApp सर्व्हरसाठी) शोधा.
  2. कॉपी करा निवडून या स्थापनेचा नेमका पत्ता घ्या.
  3. योग्य डिव्हाइसच्या घटना त्या पत्त्यावर सेट करायला संचालकाला सांगा.
  4. तो तयार असल्याचे सांगितल्यावर स्वतःच्या नंबरकडून चाचणी पाठवा.
  5. उत्तर किंवा लॉग सुरू गटाची नवीन नोंद तपासा.
  6. सहाय्यकासाठी MCP क्लायंटच्या अधिकृतता स्क्रीनवर साइन इन करा.
  7. मंजुरीपूर्वी अॅप व खाते तपासा.
  8. बाहेर संदेश पाठवण्याच्या जोडणीसाठी सेटिंग्ज → बाह्य जोडण्या उघडा. एका जोडलेल्या खात्यासाठी आणि स्पष्टपणे निवडलेल्या गटांसाठी नाव दिलेली कळ तयार करा. कळ लगेच जतन करा; ती फक्त एकदाच दाखवली जाते. API चा मूळ URL कॉपी करा.
  9. उदाहरण: America/Sao_Paulo मधील दररोजच्या आठ प्रकाशन वेळांपैकी प्रत्येक वेळी नवीन आशय तयार करण्यासाठी Abacus.AI संरचीत करा. प्रत्येक प्रकाशन तीन परवानगी असलेल्या गटांना नवीन Idempotency-Key सह पाठवा. केवळ अगदी त्याच विनंतीचा पुन्हा प्रयत्न करताना तीच कळ वापरा.
  10. लगेच रांगेत जोडण्यासाठी scheduled_at वगळा किंवा पुढील 30 दिवसांपर्यंतचा -03:00 किंवा Z (UTC) असलेला निश्चित कालमुद्रा वापरा. प्रक्रिया प्रत्येक मिनिटाला तपासते; scheduled_at ही सर्वात आधीची पात्र वेळ आहे, अचूक सेकंदाला पोहोचण्याची हमी नाही.
  11. पुन्हा प्रयत्न करण्यापूर्वी कामाची स्थिती आणि प्रत्येक गटाचा निकाल तपासा. अद्याप रवाना न झालेले पाठवणेच रद्द करा. धोक्यात आलेली कळ सेटिंग्जमध्ये रद्द करा, नंतर नवीन कळ तयार करून जतन करा; जुन्या कामांना नवीन कळीने पुन्हा सुरुवात होत नाही.

पूर्ण उदाहरण

नमुना विनंत्या; पाठवण्यापूर्वी ID बदला आणि भविष्यातील तारीख निवडा. या विनंत्या प्रत्यक्ष संदेश प्रकाशित करतात. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

यश कसे तपासावे

काम स्वीकारले जाणे आणि गटांचे स्वीकारलेले निकाल हे गेटवेने स्वीकारल्याची पुष्टी करतात. ते पोहोचल्याची किंवा वाचल्याची पुष्टी करत नाहीत. प्रवेश, कळ, खाते किंवा गटांच्या परवानग्या बदलल्यास नियोजित काम अवरोधित होऊ शकते.

काय लक्षात ठेवावे

  • सहाय्यक नोंदी वाचू आणि मागितलेला मजकूर पाठवू शकतो. आधी साधने मार्गदर्शक वाचा.
  • MCP मध्ये नसलेले बदल पॅनेलमध्ये करा.
  • API प्रवेश मासिक किंवा वार्षिक Pro आणि Agency योजनांमध्ये समाविष्ट आहे. Starter साठी श्रेणीसुधार आवश्यक आहे. कळ फक्त निवडलेल्या खात्याला आणि गटांना परवानगी देते; WhatsApp खाते बदलल्यास पाठवणे अवरोधित होते. सर्व्हरची प्रवेश माहिती कधीही सामायिक करू नका.
  • मजकुरात 4,096 अक्षरे आणि मथळ्यात 1,024 अक्षरे समर्थित आहेत. 5 MiB पर्यंतच्या JPEG, PNG किंवा WebP प्रतिमा multipart मधील payload आणि image क्षेत्रांद्वारे अपलोड करा. दूरस्थ प्रतिमांचे URL स्वीकारले जात नाहीत.
  • नवीन काम HTTP 202 परत करते. त्याच Idempotency-Key सह अगदी तसाच पुन्हा प्रयत्न केल्यास मूळ काम HTTP 200 सह मिळते; त्याच कळीने वेगळा आशय दिल्यास 409 मिळते. पाठवणे सुरू झाल्यानंतर वेळमर्यादा संपल्यास निकाल अपुष्ट असू शकतो; दुसऱ्या कळीने आपोआप पुन्हा पाठवू नका.

सामान्य अडचणी

काय दिसते
उत्तर किंवा नोंद नाही.
काय करावे
जोडणी, नियम व लॉग तपासा आणि संचालकाकडून घटना सेटअप पाहा.
काय अपेक्षित आहे
योग्य वैशिष्ट्य नवीन जुळणारी घटना प्रक्रिया करते.
काय दिसते
सहाय्यक मंजुरी होत नाही किंवा दुसरे खाते आहे.
काय करावे
प्रवेशावर परत योग्य खाते निवडा; पुनरावृत्ती त्रुटी सांगा.
काय अपेक्षित आहे
स्क्रीन व नोंदी योग्य खात्याच्या होतात.

अधिक मदत

वैशिष्ट्य व त्रुटी सांगा. सर्व्हरची गुप्त माहिती सहाय्यकाशी शेअर नको.

हे वैशिष्ट्य उघडा

संबंधित मार्गदर्शक