ఫీచర్

మీ సొంత WhatsApp నంబర్‌పై ఒక WhatsApp API

మీ టీమ్ షేర్డ్ WhatsApp ఇన్‌బాక్స్‌లో సమాధానం ఇచ్చే అదే నంబర్‌పై Spun మీకు REST API ఇస్తుంది: టెక్స్ట్, మీడియా పంపండి, సందేశాలు చదవండి, కాంటాక్ట్‌లు, లేబుళ్లు అప్‌డేట్ చేయండి, వెబ్‌హుక్‌లకు సబ్‌స్క్రైబ్ చేయండి. మీరు QR స్కాన్‌తో లింక్ చేసిన నంబర్ ముందు ఇది పనిచేస్తుంది, కాబట్టి దీనికి Business API అవసరం లేదు, ప్రతి సందేశానికి ఛార్జీ కూడా లేదు.

WhatsApp API తో చేయించే పనుల్లో ఎక్కువ భాగం నాలుగు విషయాలకే వస్తాయి: సందేశం పంపడం, ఏదైనా వెతకడం, ఒక రికార్డ్ మార్చడం, ఏదైనా జరిగినప్పుడు సమాచారం అందుకోవడం. మీ టీమ్ ఇన్‌బాక్స్‌లో సమాధానం ఇచ్చే అదే నంబర్ కోసం Spun ఈ నాలుగింటినీ సాధారణ HTTP ద్వారా అందిస్తుంది. ఆథెంటికేషన్ మీరే సృష్టించే కీతో జరుగుతుంది, ఆ కీని ఇంటిగ్రేషన్‌కు సరిగ్గా అవసరమైనంత స్కోప్‌కే పరిమితం చేస్తారు.

ఈ పేజీ దాని ఆచరణాత్మక రూపం: ఎండ్‌పాయింట్‌లు ఏవి, ఆథెంటికేషన్, స్కోపింగ్ ఎలా పనిచేస్తాయి, మీరు కాల్ చేసే క్షణంలో మీ WhatsApp లైన్ ఆఫ్‌లైన్‌లో ఉంటే ఏమవుతుంది, మెషిన్ చదవగల కాంట్రాక్ట్ ఎక్కడ ఉంటుంది.

కీలు, స్కోప్‌లు, కీ లీక్ అయితే నష్టం పరిధి

ఆథెంటికేషన్ ఒక బేరర్ టోకెన్‌తో జరుగుతుంది. మీరు యాప్‌లో ఒక కీ సృష్టిస్తారు, అది మీకు ఒక్కసారి మాత్రమే కనిపిస్తుంది, ప్రతి రిక్వెస్ట్ దాన్ని Authorization హెడర్‌లో తీసుకెళ్తుంది. Spun కీ హ్యాష్‌ను మాత్రమే నిల్వ చేస్తుంది, కాబట్టి పోయిన కీని తిరిగి పొందలేరు, దాని స్థానంలో కొత్తది మాత్రమే పెట్టగలరు.

ఒక నిమిషం కేటాయించదగిన భాగం స్కోపింగ్. కీ అంటే కేవలం "ఖాతాకు యాక్సెస్" కాదు: దానితో స్కోప్‌ల జాబితా ఉంటుంది, ప్రతి ఎండ్‌పాయింట్ తనకు అవసరమైన నిర్దిష్ట స్కోప్ ఉందో లేదో తనిఖీ చేస్తుంది. read_contacts మాత్రమే ఉన్న కీ సందేశం పంపలేదు. send_message మాత్రమే ఉన్న కీ మీ కాంటాక్ట్ జాబితాను ఒక్కొక్కటిగా తీయలేదు. స్కోప్‌లతో పాటు, కీకి గడువు తేదీ, IP అనుమతి జాబితా కూడా పెట్టవచ్చు, కాబట్టి స్థిర చిరునామా ఉన్న సర్వర్‌కు ఇచ్చిన కీని వేరే ఎక్కడి నుంచైనా వాడిన క్షణమే అది పనిచేయడం ఆగిపోతుంది.

  • send_message లో టెక్స్ట్, మీడియా పంపడం, క్యూలో ఉన్న సెండ్‌ను తిరిగి చదవడం ఉంటాయి.
  • read_contacts, read_messages, read_labels చదివే వైపు, వీటిని విడివిడిగా ఇవ్వవచ్చు.
  • manage_contacts, manage_labels సృష్టించడం, అప్‌డేట్ చేయడం, లేబుల్ వేయడం కవర్ చేస్తాయి.
  • check_phone ఒక నంబర్ WhatsApp లో అందుబాటులో ఉందో లేదో చెబుతుంది.
  • manage_webhooks వెబ్‌హుక్ సబ్‌స్క్రిప్షన్‌లను సృష్టిస్తుంది, వాటి జాబితా చూపిస్తుంది, తొలగిస్తుంది.

రిక్వెస్ట్

curl -X POST https://api.spun.com/api/integrations/send-message \
  -H "Authorization: Bearer wap_0f3c9a1d7b524e86a1c05d9e2f7b48ac" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155550142",
    "text": "Your appointment is confirmed for Thursday at 10:00.",
    "idempotency_key": "booking-8871"
  }'

రెస్పాన్స్

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "message_id": "yq0Zt9C1sK2mfE7x"
}
ఒక సందేశం పంపడం. ఐడెంపొటెన్సీ కీ ఐచ్ఛికం; అదే కీతో అదే కాల్‌ను మళ్లీ చేస్తే, రెండోసారి పంపడానికి బదులు అసలు సందేశం id మీకు తిరిగి వస్తుంది.

Spun MCP సర్వర్ కోసం సృష్టించిన కీలు చెల్లుబాటయ్యే కీలైనా సరే, ఈ API వాటిని ఉద్దేశపూర్వకంగా తిరస్కరిస్తుంది. ఈ రెండింటిలో ఆమోదం నియమాలు వేరు, ఒకదాని కోసం ఇచ్చిన కీ మరొకదానిపై నిశ్శబ్దంగా పనిచేయదు.

సంబంధిత: కోడ్ రాయడానికి బదులు AI అసిస్టెంట్‌ను కనెక్ట్ చేయడం

WhatsApp API ఎండ్‌పాయింట్‌లు నిజంగా ఏమేమి కవర్ చేస్తాయి

ఈ ఇంటర్‌ఫేస్ ఉద్దేశపూర్వకంగా చిన్నగా, స్థిరంగా ఉంచబడింది, ప్రోడక్ట్‌లోని ప్రతిదానికీ పూర్తి నకలు కాదు. బయటి సిస్టమ్‌లు నిజంగా చేయాల్సిన పనులను ఒక బయటి సిస్టమ్ చేయగలిగేలా ఇది ఉంది.

  • సెండ్: ఒక టెక్స్ట్ సందేశం, లేదా URL గా గానీ base64 గా గానీ మీడియా, ఐచ్ఛిక క్యాప్షన్‌తో.
  • కాంటాక్ట్‌లు: కాంటాక్ట్ సృష్టించండి, అప్‌డేట్ చేయండి, కర్సర్ పేజినేషన్‌తో కాంటాక్ట్‌ల జాబితా చూడండి.
  • లేబుళ్లు: వర్క్‌స్పేస్‌లోని లేబుళ్ల జాబితా చూడండి, ఒక సంభాషణకు లేబుల్ వేయండి, తీసేయండి.
  • సందేశాలు: కర్సర్ పేజినేషన్‌తో సందేశాల జాబితా, డేటా వేర్‌హౌస్‌లోకి లేదా CRM లోకి సింక్ చేయడానికి.
  • ఫోన్ తనిఖీ: ఒక నంబర్ చుట్టూ జాబితా తయారు చేసే ముందు అది WhatsApp లో ఉందో లేదో నిర్ధారించుకోండి.
  • క్యూ: లైన్ ఆఫ్‌లైన్‌లో ఉన్నందున క్యూలో పెట్టిన సెండ్‌ను చూడండి.
  • వెబ్‌హుక్‌లు: సబ్‌స్క్రిప్షన్‌లను సృష్టించండి, వాటి జాబితా చూడండి, తొలగించండి.

మెషిన్ చదవగల కాంట్రాక్ట్ /api/integrations/openapi.json వద్ద ప్రచురించబడింది, దాన్ని చదవడానికి ఏ కీ అవసరం లేదు, కాబట్టి n8n నోడ్ రాసేవారు, Zapier యాప్ తయారుచేసేవారు లేదా మీ సొంత జనరేటర్, ఎవరికీ క్రెడెన్షియల్స్ ఇవ్వకముందే స్పెక్‌ను తీసుకోవచ్చు.

WhatsApp లైన్ ఆఫ్‌లైన్‌లో ఉన్నప్పుడు ఏమవుతుంది

చాలామందిని ఆశ్చర్యపరిచే భాగం ఇదే, అందుకే దీన్ని స్పష్టంగా చెప్పాలి. Spun ఒక లైవ్ WhatsApp సెషన్ ద్వారా పంపుతుంది, మీ కోడ్ కాల్ చేసే సరిగ్గా అదే సెకనులో లైవ్ సెషన్ ఆగిపోయి ఉండవచ్చు. API దీనికి భిన్నంగా నటించదు, టెక్స్ట్‌కూ మీడియాకూ ఉద్దేశపూర్వకంగా వేర్వేరుగా ప్రవర్తిస్తుంది.

ఆఫ్‌లైన్ లైన్‌కు టెక్స్ట్ పంపితే ఎర్రర్‌కు బదులు 202 వస్తుంది, దానితో ఒక క్యూ id. సందేశం పట్టి ఉంచబడి, లైన్ మళ్లీ కనెక్ట్ అయినప్పుడు డెలివర్ అవుతుంది, దాని ఫలితం కోసం మీరు క్యూ ఎండ్‌పాయింట్‌ను పోల్ చేయవచ్చు. ఆఫ్‌లైన్ లైన్‌కు మీడియా పంపితే బదులుగా కాన్‌ఫ్లిక్ట్ వస్తుంది, ఏదీ పంపబడదు. ఈ తేడా ఉద్దేశపూర్వకం: క్యూ సందేశాలను టెక్స్ట్‌గా పంపుతుంది, కాబట్టి క్యూలో పెట్టిన చిత్రం బొమ్మ లేకుండా కేవలం క్యాప్షన్‌గా చేరుతుంది. స్పష్టంగా విఫలమవడమే మంచి ఫలితం, తర్వాత ఏం చేయాలో మీ రీట్రై లాజిక్ నిర్ణయిస్తుంది.

రేట్ పరిమితి ప్రతి కీకి నిమిషానికి 60 రిక్వెస్ట్‌లు, ప్రతి రెస్పాన్స్‌పై ప్రామాణిక రేట్ పరిమితి హెడర్‌లు ఉంటాయి, కాబట్టి ఒక క్లయింట్ ఊహించని 429 కోసం ఎదురుచూడకుండా హెడర్‌లను చూసి వేగం తగ్గించుకోవచ్చు.

వెబ్‌హుక్‌లు: పోల్ చేయడానికి బదులు సమాచారం అందుకోవడం

టైమర్‌పై సందేశాల ఎండ్‌పాయింట్‌ను మళ్లీ మళ్లీ పోల్ చేయడం సంభాషణకు సరైన పద్ధతి కాదు, అందుకే API తానే పుష్ చేయగలదు. మీరు ఒక URL ను, మీకు అవసరమైన ఈవెంట్‌లను నమోదు చేస్తారు, అవి జరిగే కొద్దీ Spun ఆ URL కు ఒక JSON బాడీని పోస్ట్ చేస్తుంది.

ప్రతి డెలివరీ హెడర్‌లలో ఈవెంట్ పేరు, ప్రత్యేకమైన డెలివరీ id ఉంటాయి, సబ్‌స్క్రిప్షన్‌కు సైనింగ్ సీక్రెట్ ఉంటే సరిగ్గా అదే బాడీకి HMAC-SHA256 సిగ్నేచర్ కూడా ఉంటుంది. పేలోడ్‌ను నమ్మే ముందు సిగ్నేచర్‌ను ధృవీకరించండి: URL తెలిసిన ఎవరి నుంచైనా మీ ఎండ్‌పాయింట్‌ను వేరు చేసేది ఇదొక్కటే. సీక్రెట్ ఒక్కసారి మాత్రమే, సబ్‌స్క్రిప్షన్ సృష్టించినప్పుడు, తిరిగి ఇవ్వబడుతుంది, మళ్లీ ఎప్పుడూ కాదు.

  • సందేశ ఈవెంట్‌లు, వచ్చేవి, వెళ్లేవి.
  • కాంటాక్ట్ సృష్టించబడింది, అప్‌డేట్ అయింది, తొలగించబడింది.
  • లేబుల్ అసైన్ అయింది.
  • చాట్ ఫ్లో పూర్తయింది, క్యూలోని సెండ్ ప్రాసెస్ అయింది, లీడ్ క్వాలిఫై అయింది.
  • సంభాషణ ముగిసింది, కాల్ పూర్తయింది, పైప్‌లైన్ దశ మారింది.

సంబంధిత: Spun ను Zapier, Make తో కనెక్ట్ చేయడం · Spun ను n8n తో కనెక్ట్ చేయడం · హెల్ప్‌డెస్క్‌ను కనెక్ట్ చేయడం: Zendesk, Zoho Desk, Freshdesk, HubSpot Service Hub, Jira

పరిమితులు, నిజాయితీగా చెప్పే హెచ్చరికలు

  • ఇది WhatsApp Business API కాదు. ఇది మీ లింక్ చేసిన నంబర్ ముందు ఉండే Spun సొంత API, కాబట్టి ఆమోదించాల్సిన సందేశ టెంప్లేట్‌లు లేవు, ప్రతి సందేశానికి ఛార్జీ లేదు, అలాగే Meta అధికారిక హామీలు కూడా లేవు.
  • ప్రతి కీకి నిమిషానికి అరవై రిక్వెస్ట్‌లు. బల్క్ పని క్యాంపెయిన్‌లలో జరగాలి, అవి తమ వేగాన్ని సరిగ్గా నియంత్రించుకుంటాయి, వేగంగా తిరిగే API లూప్‌లో కాదు.
  • పైన ఉన్న ఎండ్‌పాయింట్ జాబితానే ఈరోజు పూర్తి ఇంటర్‌ఫేస్. ఇందులో లేనిది అందుబాటులో లేదు, డాక్యుమెంట్ చేయని ఏ ఎండ్‌పాయింట్‌పైనా ఆధారపడకూడదు.
  • కీకి స్కోప్‌లు ఉంటాయి కానీ అది ఒక్కో యూజర్‌కు వేరు కాదు. దాన్ని వర్క్‌స్పేస్ క్రెడెన్షియల్స్‌లా భావించండి, యాక్సెస్ ఉన్న ఎవరైనా వెళ్లిపోయినప్పుడు దాన్ని మార్చండి.
  • ఎప్పుడూ అంగీకరించని వ్యక్తులకు సందేశాలు పంపితే, సందేశం ఏ మార్గంలో వెళ్లినా WhatsApp నంబర్‌ను పరిమితం చేస్తుంది.

సంబంధిత: Spun WhatsApp కు ఎలా కనెక్ట్ అవుతుంది

తరచుగా అడిగే ప్రశ్నలు

దీన్ని వాడటానికి నాకు WhatsApp Business API అవసరమా?

లేదు. ఇది QR స్కాన్‌తో లింక్ చేసిన మీ సొంత WhatsApp నంబర్ ముందు ఉండే Spun సొంత REST API. Meta అప్లికేషన్ లేదు, టెంప్లేట్ ఆమోదం క్యూ లేదు, ప్రతి సందేశానికి ఛార్జీ లేదు.

API కీ ఎలా పొందాలి?

ఖాతా మేనేజర్ యాప్‌లో ఒక కీ సృష్టించి, దాని స్కోప్‌లను ఎంచుకుని, కావాలంటే గడువు తేదీ, IP అనుమతి జాబితా సెట్ చేస్తారు. అసలు కీ సృష్టించినప్పుడు ఒక్కసారి మాత్రమే కనిపిస్తుంది; ఆ తర్వాత Spun దాని హ్యాష్‌ను మాత్రమే నిల్వ చేస్తుంది.

OpenAPI స్పెక్ ఉందా?

అవును, /api/integrations/openapi.json వద్ద ప్రచురించబడింది, కీ లేకుండానే చదవవచ్చు, కాబట్టి క్రెడెన్షియల్స్ ఉండకముందే టూల్స్ క్లయింట్‌ను జనరేట్ చేయగలవు.

అదే రిక్వెస్ట్‌ను రెండుసార్లు పంపితే ఏమవుతుంది?

ఐడెంపొటెన్సీ కీ పంపండి. అదే కీతో మళ్లీ చేసిన కాల్ అసలు సందేశం id ను తిరిగి ఇస్తుంది, రెండో సందేశం పంపడానికి బదులు రెస్పాన్స్‌ను ఐడెంపొటెంట్‌గా గుర్తిస్తుంది. కీ లేకపోతే, రెండు కాల్‌లు అంటే రెండు సందేశాలు.

ఒక వెబ్‌హుక్ నిజంగా Spun నుండే వచ్చిందని ఎలా ధృవీకరించాలి?

సబ్‌స్క్రిప్షన్‌కు ఒక సైనింగ్ సీక్రెట్ ఇచ్చి సిగ్నేచర్ హెడర్‌ను తనిఖీ చేయండి, అది రా రిక్వెస్ట్ బాడీకి HMAC-SHA256, sha256 తర్వాత హెక్స్ డైజెస్ట్ రూపంలో ఉంటుంది. పార్స్ చేసే ముందు, మీకు అందిన అవే బైట్‌లపై మీరే లెక్కించిన విలువతో దాన్ని పోల్చండి.

మీ కస్టమర్లు ఇప్పటికే సందేశాలు పంపే నంబర్‌పైనే నిర్మించండి

స్కోప్‌లు ఉన్న కీలు, చిన్న స్థిరమైన ఇంటర్‌ఫేస్, మిమ్మల్ని పోల్ చేయించకుండా తామే పుష్ చేసే వెబ్‌హుక్‌లు, ప్రతి సందేశానికి మీటర్ లేదు.

ఉచితంగా ప్రారంభించండి: 7 రోజులు అన్నీ

Spun ఫీచర్లన్నీ చూడండి

ఇందులో మరిన్ని: మీ టూల్స్‌తో చక్కగా కలిసిపోతుంది

మరిన్ని ఫీచర్లు, వివరంగా

వీడియో కాల్స్ · అనువాద రూమ్ · షెడ్యూల్ చేసిన సందేశాలు · AI ఆటో-రిప్లైలు · కనెక్షన్ రీజియన్ & Self Proxy · సంభాషణ నుంచే ఇమెయిల్ · ఒక్కో వ్యక్తికి ఒకే సంభాషణ · చాట్‌ల ఆటో-అసైన్ · సేల్స్ పైప్‌లైన్ · తిప్పండి-గెలవండి Lead Games · WhatsApp మార్కెటింగ్ · గ్రూప్ ఇంటెలిజెన్స్ · కాంటాక్ట్ సర్కిల్‌లు · వాయిస్ చాట్‌బాట్ · రిపోర్ట్‌లు, డైజెస్ట్‌లు · Weave · టీమ్ పనితీరు