WhatsApp మెసేజ్లు, కాంటాక్ట్లను Google Sheets లో ఆటోమేటిక్గా సేవ్ చేయండి
WhatsApp Business మెసేజ్లను Google Sheets లో ఆటోమేటిక్గా సేవ్ చేయడానికి, వాటిని n8n, Make లేదా Zapier వంటి ఆటోమేషన్ టూల్కు సంతకం చేసిన HTTP POST అభ్యర్థనలుగా పంపండి. ఆ టూల్లోని Google Sheets స్టెప్ ప్రతి మెసేజ్కు ఒక వరుస జోడిస్తుంది: సమయం, దిశ, ఫోన్ నంబర్, పేరు, టెక్స్ట్, మెసేజ్ id. ఫోన్ నంబర్ను కీగా ఉపయోగించే రెండవ ట్యాబ్ ప్రతి కాంటాక్ట్కు ఒక వరుసను ఉంచుతుంది, వారు మళ్లీ రాసినప్పుడు అది అప్డేట్ అవుతుంది.
easyCoexistence మీరు యాప్లో ఉంచే WhatsApp Business నంబర్ను Coexistence ద్వారా Meta యొక్క Cloud API కి కనెక్ట్ చేస్తుంది.
మీ URL విఫలమైతే, ఫార్వర్డ్ చేసిన డెలివరీలు సుమారు 1, 5, 30, 120, 360 మరియు 1,440 నిమిషాల తర్వాత మళ్లీ ప్రయత్నించబడతాయి.
ఫార్వర్డ్ చేసిన POST ఒక 2xx సమాధానం కోసం ఎంతసేపు వేచి ఉంటుంది, ఆ తర్వాతే ఆ డెలివరీ మళ్లీ ప్రయత్నించబడుతుంది.
Google Sheets API రైట్ అభ్యర్థనలు: ప్రతి యూజర్కు, ప్రతి ప్రాజెక్ట్కు నిమిషానికి అనుమతించబడేవి; ప్రాజెక్ట్కు 300.
Apps Script వెబ్ యాప్ అవుట్పుట్ script.googleusercontent.com లోని ఒకసారి-మాత్రమే URL కు దారి మళ్లించబడుతుంది.
Apps Script యొక్క doPost ఈవెంట్ ఆబ్జెక్ట్ బాడీ మరియు పారామీటర్లను అందిస్తుంది, HTTP అభ్యర్థన హెడర్లను కాదు.
ఏ మార్గం షీట్ను నింపాలి?
మెసేజ్లు easyCoexistence ద్వారా వచ్చే నంబర్పై రెండు మార్గాలు ఉన్నాయి, అవి వేర్వేరు అవసరాలకు సరిపోతాయి. Forward URL ను ప్రతి నంబర్కు ఒకసారి సెట్ చేస్తారు; ఏ ఆటోమేషన్ స్పందించినా లేకపోయినా, Meta యొక్క అసలు ఈవెంట్లను పంపుతుంది: కస్టమర్ మెసేజ్లు, మీ బృందం WhatsApp Business యాప్లో టైప్ చేసే సమాధానాలు మరియు డెలివరీ స్టేటస్లు. పూర్తి మెసేజ్ లాగ్ కోసం ఇది మార్గం. ఒక ఆటోమేషన్ లోపల ఉన్న Call my వెబ్హుక్ స్టెప్ ఆ ఆటోమేషన్ ఎంచుకునే మెసేజ్లకు మాత్రమే పని చేస్తుంది, మరియు ఇటీవలి చాట్ను, ఆటోమేషన్ పంపిన సమాధానంతో సహా, తీసుకువెళ్తుంది. ఒక ఆటోమేషన్ నిర్వహించే లీడ్లు, ఆర్డర్లు లేదా అభ్యర్థనల షీట్కు ఇది సరిపోతుంది. రెండూ సంతకం చేయబడతాయి, వేర్వేరు సీక్రెట్లతో.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
ఏ ఫీల్డ్లు వస్తాయి, షీట్లో ఏ కాలమ్లు ఉండాలి?
ఫార్వర్డ్ చేసిన POST ఒక Meta change ను చుట్టి ఉంటుంది: id (డెలివరీ), event (Meta యొక్క ఫీల్డ్ పేరు, ఉదాహరణకు messages లేదా smb_message_echoes), received_at, connection (మీ నంబర్ యొక్క id, phone మరియు phone_number_id) మరియు value, Meta పంపినట్లుగానే. value లో, messages లో కస్టమర్లు రాసినవి ఉంటాయి, message_echoes లో మీ బృందం ఫోన్లో టైప్ చేసినవి ఉంటాయి. ఫోన్ నంబర్లు దేశ కోడ్తో డిజిట్లుగా వస్తాయి, ప్లస్ గుర్తు లేకుండా; ఆ కాలమ్ను సాధారణ టెక్స్ట్గా నిల్వ చేయండి, తద్వారా Sheets దాన్ని నంబర్గా మార్చదు. WhatsApp యూజర్నేమ్ ఉన్న యూజర్ నంబర్తో పాటు లేదా దానికి బదులుగా బిజినెస్-స్కోప్డ్ యూజర్ ID తో రావచ్చు, కాబట్టి దానికి ఒక కాలమ్ ఉంచండి.
n8n లో మెసేజ్ లాగ్ను ఎలా నిర్మిస్తారు?
మూడు నోడ్లు. HTTP Method POST తో వెబ్హుక్ నోడ్, Respond ను Immediately కు సెట్ చేసి, దాని Production URL ను నంబర్ యొక్క Forward URL గా సేవ్ చేయండి. X-EC-Signature ను forward secret తో తనిఖీ చేసి ఈవెంట్ను వరుసలుగా మార్చే Code నోడ్, డెలివరీ స్టేటస్లను దాటవేస్తుంది. Google Sheets నోడ్ Append or Update Row ఆపరేషన్తో, Column to match on ను Message id కు సెట్ చేసి, రీట్రై చేసిన డెలివరీ ఒకే వరుసను మళ్లీ రాసేలా, కొత్తది జోడించకుండా చేస్తుంది.
ఫార్వర్డ్ సీక్రెట్ Forward URL ను సేవ్ చేసినప్పుడు ఒకసారి మాత్రమే కనిపిస్తుంది; అది పోతే, New secret పై క్లిక్ చేసి కొత్తదాన్ని పేస్ట్ చేయండి. n8n Cloud Code నోడ్లలో crypto మాడ్యూల్ను అనుమతిస్తుంది; సెల్ఫ్-హోస్ట్ చేసిన n8n కు NODE_FUNCTION_ALLOW_BUILTIN=crypto అవసరం.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));ప్రతి కాంటాక్ట్కు ఒక వరుస ఎలా ఉంచాలి?
Contacts ట్యాబ్లో మరో Google Sheets నోడ్ జోడించండి, అదీ Append or Update Row తో, Phone పై మ్యాచ్ చేయండి. ఫోన్, ప్రొఫైల్ పేరు, యూజర్ ID, సమయం, మరియు తాజా మెసేజ్ టెక్స్ట్ను మ్యాప్ చేయండి. ఒక నంబర్ నుండి మొదటి మెసేజ్ దాని వరుసను సృష్టిస్తుంది; తర్వాత వచ్చే మెసేజ్లు పేరు మరియు చివరి-కాంటాక్ట్ కాలమ్లను అప్డేట్ చేస్తాయి, కాబట్టి ఈ ట్యాబ్ ఎవరు ఎప్పుడు రాశారో చూపే జాబితాగా కూడా పనిచేస్తుంది. చేతితో రాసిన నోట్స్ను వేరే ట్యాబ్లో ఉంచండి, ఫోన్ ద్వారా వెతకండి, తద్వారా వర్క్ఫ్లో వాటిని ఎప్పుడూ ఓవర్రైట్ చేయదు.
ఫోన్ అడ్రస్ బుక్లో సేవ్ చేసిన కాంటాక్ట్లు ఈ మార్గంలో రావు. వాటిని Meta, 6 నెలల వరకు చాట్లతో కలిపి, నంబర్ కనెక్ట్ చేసిన 24 గంటల్లోపు సేవ్ చేసిన డైరెక్ట్ వెబ్హుక్ డెస్టినేషన్కు మాత్రమే పంపుతుంది.
Apps Script నేరుగా మెసేజ్లను స్వీకరించగలదా?
సరిగ్గా కాదు, కాబట్టి షీట్ ముందు ఒక వర్క్ఫ్లో టూల్ ఉంచండి. Apps Script వెబ్ యాప్ యొక్క ప్రతిస్పందనను Google, ఒకసారి-మాత్రమే script.googleusercontent.com URL కు దారి మళ్లించడం ద్వారా అందిస్తుంది, మరియు easyCoexistence దారి మళ్లింపులను అనుసరించదు. ఆ 302 ఒక విఫల డెలివరీగా లెక్కించబడుతుంది: ఫార్వర్డ్ 7 సార్లు వరకు మళ్లీ ప్రయత్నించబడుతుంది, మరియు ప్రతి రీట్రైలో doPost మళ్లీ నడిచి మరో వరుస రాస్తుంది, అయితే Call my వెబ్హుక్ స్టెప్ విఫలమై మీకు ఇమెయిల్ పంపుతుంది. doPost రిక్వెస్ట్ హెడర్లను కూడా చదవలేదు, కాబట్టి అక్కడ X-EC-Signature తనిఖీ అసాధ్యం.
Apps Script ఇతర దిశకు మంచిది, అంటే ఆమోదించిన టెంప్లేట్లను షీట్ వరుసల నుండి పంపడం, దాన్ని Google Sheets integration పేజీ కోడ్తో వివరిస్తుంది.
Make లేదా Zapier షీట్ను బదులుగా నింపగలవా?
అవును. Make లో, సీనారియోను వెబ్హుక్స్ > కస్టమ్ వెబ్హుక్ తో ప్రారంభించి Google Sheets > Add a Row జోడించండి; Zapier లో, Catch Raw Hook తో వెబ్హుక్స్ బై Zapier ను ఉపయోగించండి, ఇది హెడర్లను ఉంచుతుంది, తర్వాత Google Sheets > Create Spreadsheet Row. రెండూ POST కు వెంటనే 2xx తో సమాధానం ఇస్తాయి, ఫార్వర్డ్కు దాని 10 సెకన్లలో అవసరమైనది అదే. పైన చెప్పిన ఫీల్డ్లనే value.messages నుండి మ్యాప్ చేయండి, మరియు value లో messages కు బదులు statuses ఉన్న ఈవెంట్లను ఫిల్టర్ చేయండి.
హుక్ URL ను పాస్వర్డ్గా పరిగణించండి, ఎందుకంటే దాన్ని కలిగిన ఎవరైనా వరుసలను పోస్ట్ చేయగలరు. మీ ప్లాన్లో కోడ్ స్టెప్ ఉంటే, అక్కడ n8n నోడ్లో ఉపయోగించిన అదే HMAC రెసిపీతో X-EC-Signature ను తనిఖీ చేయండి.
డూప్లికేట్ లేదా మిస్ అయిన వరుసలను ఎలా నివారించాలి?
డూప్లికేట్లు రీట్రైల నుండి వస్తాయి. 10 సెకన్లలో 2xx రాకపోతే ఫార్వర్డ్ అదే X-EC-Delivery హెడర్తో మరియు బాడీలో అదే id తో మళ్లీ పంపబడుతుంది, లోపల ఉన్న మెసేజ్లు తమ wamid ను ఉంచుకుంటాయి, కాబట్టి Message id పై మ్యాచ్ చేస్తే రీట్రై హానికరం కాదు. వెబ్హుక్-స్టెప్ మార్గంలో, Try it నుండి వచ్చే పరీక్షలు dry_run true తో వస్తాయి: వాటిని టెస్ట్ ట్యాబ్కు పంపండి లేదా వదిలేయండి.
వరుసలు మిస్ కావడం Google యొక్క రైట్ కోటా వల్ల. Sheets API ప్రతి యూజర్కు, ప్రతి ప్రాజెక్ట్కు నిమిషానికి 60 రైట్ అభ్యర్థనలను అనుమతిస్తుంది, మరియు ఒక n8n క్రెడెన్షియల్ ఒక యూజర్; టెంప్లేట్ క్యాంపెయిన్ తర్వాత సమాధానాల తాకిడి దాన్ని మించి HTTP 429 ను పొందవచ్చు. Google Sheets నోడ్ సెట్టింగ్లలో Retry On Fail ను ఆన్ చేయండి, లేదా కొన్ని సెకన్ల మెసేజ్లను సేకరించి ఒకే అభ్యర్థనలో జోడించండి.
దీన్ని ఎలా సెటప్ చేయాలి
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
సాధారణ పొరపాట్లు
- Forward URL ను ఆటోమేషన్ యొక్క Signing secret తో తనిఖీ చేయడం, లేదా దీనికి విరుద్ధంగా. Forward URL ను నంబర్ యొక్క forward secret తో, Call my వెబ్హుక్ ను ఆటోమేషన్ యొక్క స్వంత సీక్రెట్తో సంతకం చేస్తారు; X-EC-Event హెడర్ ద్వారా సీక్రెట్ను ఎంచుకోండి.
- కీ లేకుండా ప్రతి POST కు ఒక వరుస జోడించడం. నెమ్మదైన సమాధానం తర్వాత రీట్రై చేసిన డెలివరీ అదే మెసేజ్ను రెండుసార్లు రాస్తుంది; message id పై మ్యాచ్ అయిన Append or Update Row ను ఉపయోగించండి.
- డెలివరీ స్టేటస్లను మెసేజ్లుగా రాయడం. messages ఈవెంట్లో value.statuses లో sent, delivered మరియు read స్టేటస్లు కూడా ఉంటాయి; వాటికి టెక్స్ట్ ఉండదు మరియు ఖాళీ వరుసలను సృష్టిస్తాయి.
- Apps Script వెబ్ యాప్ URL ను Forward URL గా సేవ్ చేయడం. దాని దారి మళ్లింపు విఫలంగా లెక్కించబడుతుంది, కాబట్టి 7 ప్రయత్నాలలో ప్రతి ఒకటి doPost ను మళ్లీ నడిపి ఒక నకిలీ వరుసను జోడిస్తుంది.
ఆటోమేషన్స్ ఆన్ ఉన్నప్పుడు, Forward URL Meta యొక్క అసలు ఈవెంట్లను మీ వర్క్ఫ్లోకు పంపుతుంది, మీకు మాత్రమే తెలిసిన సీక్రెట్తో సంతకం చేయబడి, మీ URL డౌన్ ఉన్నప్పుడు రీట్రై చేయబడుతుంది; Call my వెబ్హుక్ స్టెప్ ఆటోమేషన్ నిర్వహించినవాటిని, దాని సమాధానంతో సహా పంపుతుంది. రెండూ ప్లాన్లో చేర్చబడ్డాయి. ప్రతి నంబర్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు నంబర్లు పెంచిన కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
నా బృందం ఫోన్లో టైప్ చేసే మెసేజ్లు కూడా షీట్కు వస్తాయా?
అవును, Forward URL ద్వారా. WhatsApp Business యాప్లో టైప్ చేసిన సమాధానాలు to లో కస్టమర్ నంబర్తో smb_message_echoes ఈవెంట్లుగా వస్తాయి. ఆటోమేషన్స్ పంపిన సమాధానాలు డెలివరీ స్టేటస్లుగా మాత్రమే తిరిగి వస్తాయి, కాబట్టి వాటి టెక్స్ట్ను సమాధానం తర్వాత ఉంచిన Call my వెబ్హుక్ స్టెప్ నుండి లాగ్ చేయండి.
నా ఇప్పటికే ఉన్న చాట్లను షీట్లోకి లోడ్ చేయగలనా?
మెసేజ్లు easyCoexistence ద్వారా వచ్చే నంబర్లో కాదు. Meta, 6 నెలల వరకు ఒకరితో ఒకరు చాట్లను, కనెక్ట్ చేసిన 24 గంటల్లోపు సేవ్ చేసిన డైరెక్ట్ వెబ్హుక్ డెస్టినేషన్కు మాత్రమే పంపుతుంది, ప్రతి కనెక్షన్కు ఒకసారి. easyCoexistence ద్వారా రూట్ అయ్యే నంబర్ Forward URL సేవ్ చేసిన క్షణం నుండి లాగ్ చేస్తుంది.
easyCoexistence మెసేజ్ల కాపీని ఉంచుతుందా?
కొంతవరకు. ఆటోమేషన్స్ ఆన్ ఉన్న, easyCoexistence ద్వారా వెళ్లే నంబర్లో, మెసేజ్ టెక్స్ట్ మీరు ఎంచుకున్న వ్యవధి వరకు, 30, 90 లేదా 365 రోజులు (డిఫాల్ట్ 90), ఉంచబడుతుంది మరియు సంభాషణలలో చూపబడుతుంది; ఫార్వర్డ్ చేసిన డెలివరీలు మళ్లీ ప్రయత్నాల కోసం 7 రోజుల వరకు, రన్ లాగ్లు 30 రోజులు ఉంచబడతాయి. షీట్ మీ శాశ్వత కాపీ.
నా AI కస్టమర్లకు సమాధానమివ్వడానికి షీట్ను చదవగలదా?
Reply with AI స్టెప్ నుండి కాదు, అది దాని Instructions మరియు చాట్ను మాత్రమే చదువుతుంది. ఒక AI ఏజెంట్ కస్టమ్ HTTP టూల్ ద్వారా వివరాలను వెతకగలదు, మరియు Call my వెబ్హుక్ లేదా Call an API స్టెప్ ప్రశ్నను ఒక వర్క్ఫ్లోకు పంపవచ్చు, అది షీట్లో సమాధానం వెతికి సమాధానంగా తిరిగి ఇస్తుంది.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ