ఖాతా మరియు ఇంటిగ్రేషన్‌లు
బాహ్య వ్యవస్థను లేదా సహాయకుడిని అనుసంధానించండి
Pro లేదా Agency లో పరిమిత అనుమతుల కీని సృష్టించండి, తాజా విషయాన్ని ప్రచురించండి లేదా సహాయకుడిని అనుసంధానించండి.
ప్రారంభించే ముందు
WhatsApp సేవ నుంచి ఇన్‌కమింగ్ సందేశాల నోటీసులను వెబ్‌హుక్ అందుకుంటుంది. దాని సర్వర్ సెటప్ ఇంటిగ్రేషన్ నిర్వహించే వారి బాధ్యత. ప్యానెల్ వినియోగదారులు సర్వర్ సెట్టింగ్‌లను మార్చాల్సిన అవసరం లేదు. MCP ద్వారా సహాయకుడు ఖాతా టూల్స్‌ను కోరగలడు.
ఏం చేయాలి
- ఇన్‌కమింగ్ సందేశాల కోసం సెట్టింగ్‌లు తెరిచి Webhook URL కనుగొనండి.
- మీ ఖాతా అమలుకు సంబంధించిన ఖచ్చితమైన చిరునామాను పొందడానికి కాపీ చేయండి ఎంచుకోండి.
- ఆ చిరునామాతో ఉద్దేశించిన పరికరానికి ఇన్‌కమింగ్ ఈవెంట్లను కాన్ఫిగర్ చేయమని నిర్వాహకుడిని అడగండి.
- సిద్ధంగా ఉందని నిర్వాహకుడు నిర్ధారించిన తర్వాత మీ సొంత నంబర్ నుంచి పరీక్ష సందేశం వచ్చేలా ఏర్పాటు చేయండి.
- మీరు ఆశించే ఫలితాన్ని చూడండి; ఉదాహరణకు సరిపోలిన ఆటోమేటిక్ రిప్లై లేదా లాగ్ ప్రారంభించి ఉన్నప్పుడు కొత్తగా నమోదైన గ్రూప్ సందేశం.
- సహాయకుడిని కనెక్ట్ చేయడానికి, మీ MCP క్లయింట్ తెరిచిన అనుమతి స్క్రీన్ ద్వారా సైన్ ఇన్ చేయండి.
- అనుమతించే ముందు చూపిన అప్లికేషన్ పేరు, ఖాతాను పరిశీలించండి.
- బయటకు సందేశాలు పంపే అనుసంధానం కోసం, సెట్టింగ్‌లు → బాహ్య అనుసంధానాలు తెరవండి. అనుసంధానించిన ఒక ఖాతా, నిర్దిష్టంగా ఎంచుకున్న సమూహాల కోసం పేరుతో కీని సృష్టించండి. కీని వెంటనే భద్రపరచండి; అది ఒక్కసారి మాత్రమే కనిపిస్తుంది. API ఆధార URL ను కాపీ చేయండి.
- ఉదాహరణ: America/Sao_Paulo లో రోజువారీ ఎనిమిది ప్రచురణ సమయాల్లో ప్రతిసారీ తాజా విషయాన్ని రూపొందించేలా Abacus.AI ని అమర్చండి. ప్రతి ప్రచురణను కొత్త Idempotency-Key తో అనుమతించిన మూడు సమూహాలకు పంపండి. సరిగ్గా అదే అభ్యర్థనను మళ్లీ ప్రయత్నించేటప్పుడు మాత్రమే కీని తిరిగి వాడండి.
- వెంటనే క్యూలో చేర్చడానికి scheduled_at ను వదిలేయండి లేదా రాబోయే 30 రోజులలోపు -03:00 లేదా Z (UTC) తో సంపూర్ణ సమయ ముద్రను వాడండి. ప్రాసెసర్ ప్రతి నిమిషం తనిఖీ చేస్తుంది; scheduled_at అనేది అర్హత పొందే తొలి సమయం మాత్రమే, కచ్చితమైన సెకనులో చేరుతుందనే హామీ లేదు.
- మళ్లీ ప్రయత్నించే ముందు పని స్థితిని, ప్రతి సమూహం ఫలితాన్ని తనిఖీ చేయండి. ఇంకా పంపడం ప్రారంభించని వాటిని మాత్రమే రద్దు చేయండి. బహిర్గతమైన కీని సెట్టింగ్‌లలో రద్దు చేసి, కొత్త కీని సృష్టించి భద్రపరచండి; పాత పనులు కొత్త కీతో తిరిగి ప్రారంభం కావు.
వివరించిన ఉదాహరణ
ఇవి స్థానపూరక విలువలతో ఉన్న అభ్యర్థనలు; పంపే ముందు 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 ద్వారా అందుబాటులో లేని సవరణలకు ప్యానెల్ ఉపయోగించండి.
- నెలవారీ లేదా వార్షిక Pro, Agency పథకాలలో API ప్రవేశం ఉంటుంది. Starter కు అప్‌గ్రేడ్ అవసరం. కీలు ఎంచుకున్న ఖాతా, సమూహాలను మాత్రమే అనుమతిస్తాయి; WhatsApp ఖాతాను మార్చితే పంపడం నిరోధించబడుతుంది. సర్వర్ ప్రవేశ వివరాలను ఎప్పుడూ పంచుకోవద్దు.
- వచనానికి 4,096 అక్షరాలు; చిత్ర వివరణకు 1,024 అక్షరాలు అనుమతించబడతాయి. 5 MiB వరకు JPEG, PNG లేదా WebP ను multipart ఫీల్డ్‌లు payload, image ద్వారా అప్‌లోడ్ చేయండి. దూరస్థ చిత్ర URL లు ఆమోదించబడవు.
- కొత్త పని HTTP 202 ను ఇస్తుంది. అదే Idempotency-Key తో అదే అభ్యర్థనను మళ్లీ ప్రయత్నిస్తే అసలు పని HTTP 200 తో వస్తుంది; అదే కీతో భిన్నమైన విషయం పంపితే 409 వస్తుంది. పంపడం మొదలైన తర్వాత సమయం ముగిస్తే ఫలితం నిర్ధారణ లేకుండా ఉండవచ్చు; వేరే కీతో స్వయంచాలకంగా మళ్లీ పంపవద్దు.
సాధారణ సమస్యలు
- మీకు కనిపించేది
- పరీక్ష తర్వాత రిప్లై లేదా కొత్త రికార్డు కనిపించలేదు.
- ఏం చేయాలి
- పరికరం కనెక్షన్, సంబంధిత నియమం లేదా లాగ్ సెట్టింగ్‌ను చూడండి; తర్వాత ఇన్‌కమింగ్ ఈవెంట్ల కాన్ఫిగరేషన్ ధృవీకరించమని నిర్వాహకుడిని అడగండి.
- ఏం ఆశించాలి
- సరిగ్గా కాన్ఫిగర్ చేసిన ఫీచర్ కొత్తగా సరిపోలిన ఈవెంట్‌ను ప్రాసెస్ చేయగలదు.
- మీకు కనిపించేది
- సహాయకుడు అనుమతి పొందలేకపోతున్నాడు లేదా వేరే ఖాతా కనిపిస్తోంది.
- ఏం చేయాలి
- సైన్ ఇన్‌కు తిరిగి వెళ్లి ఉద్దేశించిన ఖాతాను ఎంచుకోండి; అనుమతి లోపాలు మళ్లీ వస్తే నిర్వాహకుడికి తెలియజేయండి.
- ఏం ఆశించాలి
- అనుమతి స్క్రీన్, తిరిగి వచ్చిన రికార్డులు ఉద్దేశించిన ఖాతాకు చెందినవి అవుతాయి.
మరింత సహాయం పొందండి
ఫీచర్, కనిపించే లోపాన్ని నిర్వాహకుడికి ఇవ్వండి. సర్వర్ ఆధారాలను సహాయకుడితో సంభాషణల్లో పంచుకోవద్దు.