ଉପରେ ନିର୍ମାଣ କରନ୍ତୁ ଟେକ୍ ପ୍ୟାଡ୍ API.
ଆପଣଙ୍କର ସ୍ୱୟଂ ସିଷ୍ଟମରୁ WhatsApp ଟେମ୍ପଲେଟ୍ ସନ୍ଦେଶ ପଠାନ୍ତୁ, webhook ଦ୍ୱାରା ଡିଲିଭେରି ଘଟଣାଗୁଡିକୁ ଗ୍ରହଣ କରନ୍ତୁ ଏବଂ ଲଗ୍ରେ ପ୍ରତ୍ୟେକ ଅନୁରୋଧକୁ ନିରୀକ୍ଷଣ କରନ୍ତୁ।
କୋଡ୍ ଛାଡିଦିଅନ୍ତୁ — ଏକ କନେକ୍ଟର୍ ପ୍ଲଗଇନ୍ ଇନଷ୍ଟଲ୍ କରନ୍ତୁ।
ସେହି WhatsApp Business API, ଆପଣଁଙ୍କର ବ୍ୟବହୃତ ସାଧନ ସହିତ ମୁକ୍ତ କନେକ୍ଟର୍ ପ୍ଲଗଇନ୍ସ ରେ ଲପେଟାଯାଇଛି — ପ୍ରତିଟି ଫର୍ମ୍, ବୁକିଂ, ଇଭେଣ୍ଟ ଏବଂ ଷ୍ଟୋର୍ ପ୍ଲାଟଫର୍ମ ସିଧାସଳଖ ଆପଣଙ୍କର WhatsApp କୁ ପଠାଏ। ଇନଷ୍ଟଲ୍ କରନ୍ତୁ, ଆପଣଙ୍କର ଇମେଲ୍ ସହିତ କନେକ୍ଟ କରନ୍ତୁ, ସମ୍ପୂର୍ଣ୍ଣ।
ତ୍ୱରିତ ଆରମ୍ଭ
ଶୂନ୍ୟରୁ ଚାରିଟି ପଦକ୍ରମରେ ଏକ WhatsApp ସନ୍ଦେଶ ପ୍ରେଷିତ କରାଯିବ। ଏଠାରେ ସବୁକିଛି ଆପ୍ଲିକେସନ୍ ଭିତରେ ମଧ୍ୟ କାମ କରେ। ଡିଭେଲପର୍ସ → ସାରାଂଶ ପୃଷ୍ଠା, ଯାହା ଆପଣଙ୍କର ପ୍ରଗତିକୁ ଟ୍ର୍ୟାକ୍ କରେ।
ଏକ API କି ସୃଷ୍ଟି କରନ୍ତୁ
ଖୋଲିବା ଡିଭେଲପର୍ସ → API କୀସ୍ ଆପ୍ରେ ଏବଂ ଏକ କୀ (ପ୍ରିଫିକ୍ସ) ସৃষ্টি କରନ୍ତୁ ttp_live_). ସମ୍ପୂର୍ଣ୍ଣ ଗୁପ୍ତ ରହସ୍ୟ ଦେଖାଯାଇଛି ଏକଥା — ସେଥିକୁ ତୁରନ୍ତ ନକଲ କର।
ଏକ ମଞ୍ଜୁରିକୃତ ଟେମ୍ପଲେଟ୍ ବାଛନ୍ତୁ
ଆପଣଙ୍କର କାର୍ଯ୍ୟସ୍ଥଳରେ କମେ କମ ଗୋଟିଏ ମେଟା-ମଞ୍ଜୁରିକୃତ ଟେମ୍ପଲେଟ୍ ଦରକାର (ଦେଖନ୍ତୁ ଟେମ୍ପ୍ଲେଟ୍ସ). ସାଞ୍ଜାଳ ମଧ୍ୟରୁ ସାଧାରଣତଃ ଟେମ୍ପଲେଟ୍ସ ତାଜାକରାଯାଏ।
ଟେସ୍ଟ ଅନୁରୋଧ ପଠାନ୍ତୁ
ଆପ୍ରେ ବ୍ୟବହାର କରନ୍ତୁ API ପରୀକ୍ଷକ କିମ୍ବା ନିମ୍ନଲିଖିତ ଅନୁରୋଧ। ଗ୍ରହୀତାଙ୍କୁ ଆପଣଙ୍କ ନମ୍ବରରୁ ଟେମ୍ପଲେଟ୍ ସନ୍ଦେଶ ପ୍ରାପ୍ତ କରିବାକୁ ଅନୁମୋଦନା ଦେଇଥିବା ଦରକାର।
ଏକ ଡିଲିଭେରୀ ଓେବହୁକ୍ ଯୋଗ କରନ୍ତୁ
ଆପଣଙ୍କର HTTPS ଏଣ୍ଡପଏଣ୍ଟରେ ଏକ ୱେବହୁକ୍ ପଏଣ୍ଟ କରନ୍ତୁ, ଯେଉଁ ଘଟଣାମାନଙ୍କୁ ଆପଣ ଦୁର୍ବେଳା କରିବାକୁ ଚାହାନ୍ତି ସେଗୁଡ଼ିକୁ ଚୟନ କରନ୍ତୁ, ଏବଂ ଦେଖନ୍ତୁ ୱେବହୁକ୍ ଲଗ୍ସ ଜବାବଦେହିତା ନିଶ୍ଚିତ କରନ୍ତୁ।
ପ୍ରମାଣିକରଣ
APIଟି ପ୍ରତ୍ୟେକ-ୱାର୍କସ୍ପେସ୍ API କି ସହିତ ବେୟାର ଟୋକନ୍ ଭାବେ ପ୍ରମାଣିକୃତ। କିଗୁଡିକୁ ସୃଷ୍ଟି କରାଯାଏ ଏବଂ ବାତିଲ୍ କରାଯାଏ ଡିଭେଲପର୍ସ → API କୀସ୍.
- କୀଗୁଡ଼ି ଆରମ୍ଭ ହୁଏ
ttp_live_ଏବଂ ଏହାଗୁଡିକୁ ଗୋଟିଏ କାର୍ଯ୍ୟକ୍ଷେତ୍ରରେ ସୀମିତ କରାଯାଇଛି। - ପ୍ରତ୍ୟେକ ସଂଯୋଜନ ପାଇଁ ଏକ ଅଲଗା କି ତିଆରି କରନ୍ତୁ — ପ୍ରତ୍ୟେକ କି ନିଜସ୍ୱ କଥା ଟ୍ରାକ୍ କରେ
last usedଟାଇମସ୍ଟ୍ୟାମ୍ପ୍। - ସମ୍ପୂର୍ଣ୍ଣ ଗୁପ୍ତ ସୂଚନା କେବଳ ସୃଷ୍ଟି ସମୟରେ ଏକଥର ପ୍ରଦର୍ଶିତ ହୁଏ; ପରେ ଏହାକୁ ପୁନଃପ୍ରାପ୍ତ କରାଯାଇପାରିବ ନାହିଁ। ପୁନଃସୃଷ୍ଟି କରିବାକୁ ବଦଳାୟନ କରନ୍ତୁ।
- ଚାବିକୁ ମଧ୍ୟରେ ପଠାନ୍ତୁ
Authorizationମୁଖ୍ୟ ଶୀର୍ଷକ:Authorization: Bearer ttp_live_…
ଜଣାପଡ଼ା ଦିଅ
ଆପଣଙ୍କ ଓର୍ଗାନାଇଜେସନରେ ସଂଯୁକ୍ତ ସଂଖ୍ୟାରୁ ଏକ ନିର୍ବାଚିତ ଗ୍ରାହକଙ୍କୁ ଅନୁମୋଦିତ WhatsApp ଟେମ୍ପଲେଟ୍ ସନ୍ଦେଶ ପଠାଏ।
https://v1.thetechpad.com/functions/v1/api-send
ହେଡର୍: Authorization: Bearer ttp_live_… · Content-Type: application/json
ରିକ୍ୱେଷ୍ଟ ବଡି
| କ୍ଷେତ୍ର | ପ୍ରକାର | ବିବରଣୀ |
|---|---|---|
phoneNumberId | ସ୍ତ୍ରିଙ୍ଗ | ଆପଣଙ୍କ ଓର୍ଗାନାଇଜେସନରେ ସଂଯୁକ୍ତ WhatsApp ସଂଖ୍ୟାର ID (WhatsApp ସଂଖ୍ୟା ପୃଷ୍ଠା)। |
to | ସ୍ତ୍ରିଙ୍ଗ | ଗ୍ରାହକର ଫୋନ୍ ନମ୍ବର E.164 ଫର୍ମାଟରେ, ଯଥା ଉଦାହରଣସ୍ୱରୂପ: 15551234567. |
template.name | ସ୍ତ୍ରିଙ୍ଗ | ଆପଣଙ୍କର କାର୍ୟସ୍ଥଳରେ Meta-ମାନ୍ୟତାପ୍ରାପ୍ତ ଟେମ୍ପଲେଟର ନାମ, ଯଥା ଉଦାହରଣସ୍ୱରୂପ: order_update. |
template.language | ସ୍ତ୍ରିଙ୍ଗ | ଟେମ୍ପଲେଟର ଭାଷା କୋଡ୍, ଯଥା ଉଦାହରଣସ୍ୱରୂପ: en. |
template.parameters | array<string> | ଟେମ୍ପଲେଟର ଭାରିୟବଲକୁ ଅନୁକ୍ରମରେ ପୋସିସନାଲ ମୂଲ୍ୟ। |
ଉଦାହରଣ ଅନୁରୋଧ
curl -X POST 'https://v1.thetechpad.com/functions/v1/api-send' \ -H 'Authorization: Bearer ttp_live_...' \ -H 'Content-Type: application/json' \ -d '{ "phoneNumberId": "1122334455", "to": "15551234567", "template": { "name": "order_update", "language": "en", "parameters": ["Ava", "#4031"] } }'
// JavaScript
const response = await fetch('https://v1.thetechpad.com/functions/v1/api-send', {
method: 'POST',
headers: { Authorization: 'Bearer ttp_live_...', 'Content-Type': 'application/json' },
body: JSON.stringify({
phoneNumberId: '1122334455',
to: '15551234567',
template: { name: 'order_update', language: 'en', parameters: ['Ava', '#4031'] }
})
});
ଓୟେବହୁକ୍ସ
ଆଉଟବାଉଣ୍ଡ ହେବୁକ୍ସ ସନ୍ଦେଶ ଜୀବନଚକ୍ର ଘଟଣାଗୁଡିକୁ ଲଗଭଗ ସମୟରେ ଆପଣଙ୍କର HTTPS ଏଣ୍ଡପୋଇଣ୍ଟକୁ ପୁସ୍ କରେ। ଇଣ୍ଡପୋଇଣ୍ଟଗୁଡିକୁ ପରିଚାଳନା କରନ୍ତୁ ଡିଭେଲପର୍ସ → ହେବୁକ୍ସ — ଯୋଗ କରନ୍ତୁ, ସଂପାଦନା କରନ୍ତୁ, ବିରତି ଦିଅନ୍ତୁ, ପରୀକ୍ଷା କରନ୍ତୁ ଏବଂ ବିଲୋପ କରନ୍ତୁ।
ଘଟଣାଗୁଡିକ
| ଘଟଣା | ଘଟେ କେବେ |
|---|---|
message.sent | ଏକ ସନ୍ଦେଶ WhatsApp ପ୍ଲାଟଫର୍ମ ଦ୍ୱାରା ଗ୍ରହଣ କରାଯାଇଥିଲା ଏବଂ ପଠାଯାଇଥିଲା। |
message.delivered | ସନ୍ଦେଶଟି ଗ୍ରହୀତାଙ୍କ ଡିଭାଇସକୁ ପ୍ରେରିତ ହୋଇଛି। |
message.read | ଗ୍ରହୀତା ସନ୍ଦେଶଟି ପଢିଛନ୍ତି। |
message.failed | ସନ୍ଦେଶ ବିଫଳ ହେଇଛି (ପ୍ରେରଣ ଯୋଗ୍ୟ ନୁହେଁ, ଟେମ୍ପଲେଟ୍ ରଦ୍ଦ, ପ୍ରେରକ ସୀମା, …)। |
message.received | ଗ୍ରାହକଙ୍କଠାରୁ ଏକ ଆଗମନ ସନ୍ଦେଶ ଆସିଛି। |
- Endpoints ହେବା ଦରକାର HTTPS ଏବଂ ଇଣ୍ଟରନେଟ୍ ଠାରୁ ପହଞ୍ଚଯୋଗ୍ୟ ହୋଇଛି।
- ପ୍ରତ୍ୟେକ ଏଣ୍ଡପଇଣ୍ଟ ବାଛାଯାଇଥିବା କିଛି ଘଟଣାରେ ସଦସ୍ୟତା ନେଇଥାଏ; ପ୍ରତ୍ୟେକ ଘଟଣା JSON ପେଲୋଡ ସହିତ ଚାଲୁ ହୋଇଥାଏ ଯାହାରେ ସନ୍ଦେଶ ଆଇଡି ଏବଂ ସ୍ଥିତି ଥାଏ।
- ବ୍ୟବହାର କରନ୍ତୁ ପରୀକ୍ଷା କରନ୍ତୁ ଏକ ଏଣ୍ଡପଏଣ୍ଟରେ ଏକ ନମୁନା ଡିଲିଭେରି ପଠାଇବା ଏବଂ ଆପଣଙ୍କର ହ୍ୟାଣ୍ଡଲର୍ ବାହାଲ କରିବା ପାଇଁ।
- ବିରତ ଥିବା ଏଣ୍ଡପଏଣ୍ଟଗୁଡିକ ତାଙ୍କର ଗଠନ ସଂରକ୍ଷଣ କରନ୍ତି କିନ୍ତୁ ଘଟଣାଗୁଡିକ ଗ୍ରହଣ କରିବାରୁ ବନ୍ଦ ହୋଇଯାନ୍ତି।
ରେଟ୍ ସୀମା
ସନ୍ଦେଶଗୁଡିକ ଆପଣଙ୍କର ପ୍ଲାନର ପ୍ୟାକେଜ୍ ଦରରେ ପଠାଯାଉଛି। ଯଥାର୍ଥ ପ୍ରବାହ ନିମ୍ନ ହୋଇପାରେ ଯେତେବେଳେ ମେଟା ସନ୍ଦେଶ-ସ୍ତର, ଫୋନ୍ ଗୁଣବତ୍ତା କିମ୍ବା ଖାତା-ସ୍ତର ସୀମା ଲାଗୁ କରେ। ସନ୍ଦେଶଗୁଡିକ ସୁରକ୍ଷିତ ଭାବରେ କ୍ୟୁରେଡ୍ ପ୍ରତ୍ୟାଖ୍ୟାନ କରାଯିବାର ବଦଳରେ।
| ଯୋଜନା | API କଲ୍ / ମାସ | ମୂଳ ପ୍ରେଷଣ ହାର |
|---|---|---|
| କ୍ୟାମ୍ପେନ୍ ଷ୍ଟାର୍ଟର୍ | — | ମିନିଟ୍ ପ୍ରତି 6 ସନ୍ଦେଶ ପର୍ଯ୍ୟନ୍ତ |
| ଲଞ୍ଚ | 10,000 | ପ୍ୟାକେଜ୍ ହାର |
| ଗ୍ରୋ | 200,000 | ପ୍ୟାକେଜ୍ ହାର |
| ସ୍କେଲ୍ | 2,000,000 | ପ୍ୟାକେଜ୍ ହାର |
ପ୍ରତିଟି ଅନୁରୋଧ ଆପଣଙ୍କର API କଲ୍ ହାର ନିମନ୍ତେ ଗଣନା କରାଯାଏ ଏବଂ ଏହାର ଅବସ୍ଥା କୋଡ୍ ଏବଂ ସମୟ ସହିତ API ଲଗ୍ସରେ ରେକର୍ଡ କରାଯାଏ।
ଲଗ୍ସ୍ ଏବଂ ମନିଟରିଂ
ଡେଭେଲପର୍ → ଲଗ୍ସ ଦୁଇଟି ଭ୍ୟୁ ଧରେ:
- API ଲଗ୍ସ — ପ୍ରତ୍ୟେକ API ଅନୁରୋଧ: ପ୍ରକୃତି, ଏଣ୍ଡପଏଣ୍ଟ୍, HTTP ଅବସ୍ଥା କୋଡ୍, ବ୍ୟବହୃତ ଟେମ୍ପଲେଟ୍ ଏବଂ ସମୟ ସହିତ।
- ୱେବହୁକ୍ ଲଗ୍ସ — ପ୍ରତ୍ୟେକ webhook ଡିଲିଭେରୀ ପ୍ରୟାସ ଏବଂ ତାହାର ପରିଣାମ।
ଏହାକୁ ବ୍ୟବହାର କରନ୍ତୁ ବିଫଳ ହୋଇଥିବା ପ୍ରେରଣାଗୁଡିକୁ ଡିବଗ୍ କରିବା ପାଇଁ, webhook ଡିଲିଭେରୀକୁ ସଂଶୋଧନ କରିବା ପାଇଁ ଏବଂ ସମସ୍ତ ଇଣ୍ଟେଗ୍ରେସନ୍ କୁ ଅଡିଟ୍ କରିବା ପାଇଁ।
ଭୁଲ
ସଫଳ ଅନୁରୋଧଗୁଡିକ ଏକ status ଫେରାଇଥାଏ। 2xx ବିଫଳତା ଗୁଡିକ non-2xx status ସହିତ ଏକ JSON ଶରୀରକୁ ଫେରାଇଥାଏ, ଯାହା ସମସ୍ୟାକୁ ବର୍ଣ୍ଣନା କରିଥାଏ:
{
"error": "Template not approved",
"hint": "Check the template status in Templates — only APPROVED templates can be sent."
}
| ସ୍ଥିତି | ଅର୍ଥ |
|---|---|
2xx | ଅନୁରୋଧକୁ ଗ୍ରହଣ / ପ୍ରକ୍ରିୟା କରାଗଲା। |
400 | ଖରାପ ଅନୁରୋଧ — ନିର୍ଦ୍ଦିଷ୍ଟ କିମ୍ବା ଅବୈଧ ଫିଲ୍ଡ ହାରାଇଛି। |
401 | API କୀ ହାରାଇଛି କିମ୍ବା ଅବୈଧ। |
403 | କୀ ବୈଧ ହେଲେ ଏହି କାର୍ଯ୍ୟ କିମ୍ବା କାର୍ଯ୍ୟସ୍ଥଳ ପାଇଁ ଅନୁମତି ନାହିଁ। |
404 | ଅଜଣା ସଂଖ୍ୟା, ଛାଞ୍ଚ କିମ୍ବା ସାଧନ। |
429 | ଦର ସୀମା କିମ୍ବା କ୍ୱୋଟା ଅତିକ୍ରମ — ବ୍ୟାକଓଫ୍ ପରେ ପୁନଃଚେଷ୍ଟା କରନ୍ତୁ। |
5xx | ପ୍ଲାଟଫର୍ମ ତ୍ରୁଟି — ପୁନଃଚେଷ୍ଟା କରନ୍ତୁ; API ଲଗ୍ ଓ ସ୍ଥିତି ପୃଷ୍ଠା ଯାଞ୍ଚ କରନ୍ତୁ। |
କନସୋଲ୍ରୁ API ଚେଷ୍ଟା କରନ୍ତୁ।
ଇନ-ଆପ୍ API ଟେସ୍ଟର୍ ପ୍ରତି ଅନୁରୋଧ ପାଇଁ curl, JavaScript ଏବଂ PHP ସୃଜନ କରେ।