ଡିଭେଲପର୍ ଡକ୍ୟୁମେଣ୍ଟେସନ୍

ଉପରେ ନିର୍ମାଣ କରନ୍ତୁ ଟେକ୍ ପ୍ୟାଡ୍ API.

ଆପଣଙ୍କର ସ୍ୱୟଂ ସିଷ୍ଟମରୁ WhatsApp ଟେମ୍ପଲେଟ୍ ସନ୍ଦେଶ ପଠାନ୍ତୁ, webhook ଦ୍ୱାରା ଡିଲିଭେରି ଘଟଣାଗୁଡିକୁ ଗ୍ରହଣ କରନ୍ତୁ ଏବଂ ଲଗ୍‌ରେ ପ୍ରତ୍ୟେକ ଅନୁରୋଧକୁ ନିରୀକ୍ଷଣ କରନ୍ତୁ।

ମୁକ୍ତ WordPress ପ୍ଲଗଇନ୍ସ

କୋଡ୍ ଛାଡିଦିଅନ୍ତୁ — ଏକ କନେକ୍ଟର୍ ପ୍ଲଗଇନ୍ ଇନଷ୍ଟଲ୍ କରନ୍ତୁ।

ସେହି WhatsApp Business API, ଆପଣଁଙ୍କର ବ୍ୟବହୃତ ସାଧନ ସ‌ହିତ ମୁକ୍ତ କନେକ୍ଟର୍ ପ୍ଲଗଇନ୍ସ ରେ ଲପେଟାଯାଇଛି — ପ୍ରତିଟି ଫର୍ମ୍, ବୁକିଂ, ଇଭେଣ୍ଟ ଏବଂ ଷ୍ଟୋର୍ ପ୍ଲାଟଫର୍ମ ସିଧାସଳଖ ଆପଣଙ୍କର WhatsApp କୁ ପଠାଏ। ଇନଷ୍ଟଲ୍ କରନ୍ତୁ, ଆପଣଙ୍କର ଇମେଲ୍ ସ‌ହିତ କନେକ୍ଟ କରନ୍ତୁ, ସମ୍ପୂର୍ଣ୍ଣ।

ତ୍ୱରିତ ଆରମ୍ଭ

ଶୂନ୍ୟରୁ ଚାରିଟି ପଦକ୍ରମରେ ଏକ WhatsApp ସନ୍ଦେଶ ପ୍ରେଷିତ କରାଯିବ। ଏଠାରେ ସବୁକିଛି ଆପ୍ଲିକେସନ୍ ଭିତରେ ମଧ୍ୟ କାମ କରେ। ଡିଭେଲପର୍ସ → ସାରାଂଶ ପୃଷ୍ଠା, ଯାହା ଆପଣଙ୍କର ପ୍ରଗତିକୁ ଟ୍ର୍ୟାକ୍ କରେ।

1

ଏକ API କି ସୃଷ୍ଟି କରନ୍ତୁ

ଖୋଲିବା ଡିଭେଲପର୍ସ → API କୀସ୍ ଆପ୍‌ରେ ଏବଂ ଏକ କୀ (ପ୍ରିଫିକ୍ସ) ସৃষ্টি କରନ୍ତୁ ttp_live_). ସମ୍ପୂର୍ଣ୍ଣ ଗୁପ୍ତ ରହସ୍ୟ ଦେଖାଯାଇଛି ଏକଥା — ସେଥିକୁ ତୁରନ୍ତ ନକଲ କର।

2

ଏକ ମଞ୍ଜୁରିକୃତ ଟେମ୍ପଲେଟ୍ ବାଛନ୍ତୁ

ଆପଣଙ୍କର କାର୍ଯ୍ୟସ୍ଥଳରେ କମେ କମ ଗୋଟିଏ ମେଟା-ମଞ୍ଜୁରିକୃତ ଟେମ୍ପଲେଟ୍ ଦରକାର (ଦେଖନ୍ତୁ ଟେମ୍ପ୍ଲେଟ୍ସ). ସାଞ୍ଜାଳ ମଧ୍ୟରୁ ସାଧାରଣତଃ ଟେମ୍ପଲେଟ୍ସ ତାଜାକରାଯାଏ।

3

ଟେସ୍ଟ ଅନୁରୋଧ ପଠାନ୍ତୁ

ଆପ୍‌ରେ ବ୍ୟବହାର କରନ୍ତୁ API ପରୀକ୍ଷକ କିମ୍ବା ନିମ୍ନଲିଖିତ ଅନୁରୋଧ। ଗ୍ରହୀତାଙ୍କୁ ଆପଣଙ୍କ ନମ୍ବରରୁ ଟେମ୍ପଲେଟ୍ ସନ୍ଦେଶ ପ୍ରାପ୍ତ କରିବାକୁ ଅନୁମୋଦନା ଦେଇଥିବା ଦରକାର।

4

ଏକ ଡିଲିଭେରୀ ଓେବହୁକ୍ ଯୋଗ କରନ୍ତୁ

ଆପଣଙ୍କର HTTPS ଏଣ୍ଡପଏଣ୍ଟରେ ଏକ ୱେବହୁକ୍ ପଏଣ୍ଟ କରନ୍ତୁ, ଯେଉଁ ଘଟଣାମାନଙ୍କୁ ଆପଣ ଦୁର୍ବେଳା କରିବାକୁ ଚାହାନ୍ତି ସେଗୁଡ଼ିକୁ ଚୟନ କରନ୍ତୁ, ଏବଂ ଦେଖନ୍ତୁ ୱେବହୁକ୍ ଲଗ୍ସ ଜବାବଦେହିତା ନିଶ୍ଚିତ କରନ୍ତୁ।

ପ୍ରମାଣିକରଣ

APIଟି ପ୍ରତ୍ୟେକ-ୱାର୍କସ୍ପେସ୍ API କି ସହିତ ବେୟାର ଟୋକନ୍ ଭାବେ ପ୍ରମାଣିକୃତ। କିଗୁଡିକୁ ସୃଷ୍ଟି କରାଯାଏ ଏବଂ ବାତିଲ୍ କରାଯାଏ ଡିଭେଲପର୍ସ → API କୀସ୍.

  • କୀଗୁଡ଼ି ଆରମ୍ଭ ହୁଏ ttp_live_ ଏବଂ ଏହାଗୁଡିକୁ ଗୋଟିଏ କାର୍ଯ୍ୟକ୍ଷେତ୍ରରେ ସୀମିତ କରାଯାଇଛି।
  • ପ୍ରତ୍ୟେକ ସଂଯୋଜନ ପାଇଁ ଏକ ଅଲଗା କି ତିଆରି କରନ୍ତୁ — ପ୍ରତ୍ୟେକ କି ନିଜସ୍ୱ କଥା ଟ୍ରାକ୍ କରେ last used ଟାଇମସ୍ଟ୍ୟାମ୍ପ୍।
  • ସମ୍ପୂର୍ଣ୍ଣ ଗୁପ୍ତ ସୂଚନା କେବଳ ସୃଷ୍ଟି ସମୟରେ ଏକଥର ପ୍ରଦର୍ଶିତ ହୁଏ; ପରେ ଏହାକୁ ପୁନଃପ୍ରାପ୍ତ କରାଯାଇପାରିବ ନାହିଁ। ପୁନଃସୃଷ୍ଟି କରିବାକୁ ବଦଳାୟନ କରନ୍ତୁ।
  • ଚାବିକୁ ମଧ୍ୟରେ ପଠାନ୍ତୁ Authorization ମୁଖ୍ୟ ଶୀର୍ଷକ: Authorization: Bearer ttp_live_…
କୌଣସି ସମୟରେ ଆପଣଙ୍କ API କୀକୁ ସାମ୍ନାରେ ନେବେନାହିଁ କ୍ଲାୟେଣ୍ଟ-ସାଇଡ୍ କୋଡ୍, ମୋବାଇଲ୍ ଆପ୍ସ କିମ୍ବା ସାର୍ବଜନୀନ ରେପୋଜିଟୋରୀରେ। କୀମାନେ କେବଳ ଆପଣଙ୍କର ସେର୍ଭର ଏବଂ ସୁରକ୍ଷିତ ବ୍ୟାକେଣ୍ଡ ପାଇଁ ଥିବାରିଛି।

ଜଣାପଡ଼ା ଦିଅ

ଆପଣଙ୍କ ଓର୍ଗାନାଇଜେସନରେ ସଂଯୁକ୍ତ ସଂଖ୍ୟାରୁ ଏକ ନିର୍ବାଚିତ ଗ୍ରାହକଙ୍କୁ ଅନୁମୋଦିତ WhatsApp ଟେମ୍ପଲେଟ୍ ସନ୍ଦେଶ ପଠାଏ।

POST 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.parametersarray<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ଖରାପ ଅନୁରୋଧ — ନିର୍ଦ୍ଦିଷ୍ଟ କିମ୍ବା ଅବୈଧ ଫିଲ୍ଡ ହାରାଇଛି।
401API କୀ ହାରାଇଛି କିମ୍ବା ଅବୈଧ।
403କୀ ବୈଧ ହେଲେ ଏହି କାର୍ଯ୍ୟ କିମ୍ବା କାର୍ଯ୍ୟସ୍ଥଳ ପାଇଁ ଅନୁମତି ନାହିଁ।
404ଅଜଣା ସଂଖ୍ୟା, ଛାଞ୍ଚ କିମ୍ବା ସାଧନ।
429ଦର ସୀମା କିମ୍ବା କ୍ୱୋଟା ଅତିକ୍ରମ — ବ୍ୟାକଓଫ୍‌ ପରେ ପୁନଃଚେଷ୍ଟା କରନ୍ତୁ।
5xxପ୍ଲାଟଫର୍ମ ତ୍ରୁଟି — ପୁନଃଚେଷ୍ଟା କରନ୍ତୁ; API ଲଗ୍ ଓ ସ୍ଥିତି ପୃଷ୍ଠା ଯାଞ୍ଚ କରନ୍ତୁ।

କନସୋଲ୍‌ରୁ API ଚେଷ୍ଟା କରନ୍ତୁ।

ଇନ-ଆପ୍‌ API ଟେସ୍ଟର୍ ପ୍ରତି ଅନୁରୋଧ ପାଇଁ curl, JavaScript ଏବଂ PHP ସୃଜନ କରେ।

ଆମ ସହ ଚାଟ୍ କରନ୍ତୁ