ડેવલપર દસ્તાવેજ

બનાવો ટેક પૅડ API પર.

તમારા પોતાના સિસ્ટમમાંથી વોટ્સએપ ટેમ્પલેટ સંદેશા મોકલો, વેબહૂક દ્વારા ડિલિવરી ઇવેન્ટ્સ પ્રાપ્ત કરો અને લોગ્સમાં દરેક વિનંતીનું મોનીટરીંગ કરો.

મફત વર્ડપ્રેસ પ્લગઇન્સ

કોડ છોડો — કનેક્ટર પ્લગઇન ઇન્સ્ટોલ કરો.

સમાન WhatsApp બિઝનેસ API, જે તમારા પહેલાથી જ ઉપયોગમાં લેવાતા ટૂલ્સ માટે મફત કનેક્ટર પ્લગઇન્સમાં સમાવિષ્ટ છે — દરેક ફોર્મ, બુકિંગ, ઇવેન્ટ અને સ્ટોર પ્લેટફોર્મ સીધા તમારા WhatsApp પર મોકલે છે. ઇન્સ્ટોલ કરો, તમારા ઇમેલ સાથે કનેક્ટ કરો, પૂરુ!

ઝડપી પ્રારંભ

શૂન્ય પાસેથી ચાર પગલાંમાં વૉટ્સએપ સંદેશ પહોંચાડવો. અહીં બધું એપ્લિકેશનની અંદર પણ કાર્ય કરે છે ડેવલપર → સમીક્ષા પાનું, જે તમારી પ્રગતિને ટ્રેક કરે છે.

1

એપીઆઈ કી બનાવો

ઓપન ડેવલપર → API કીઓ એપમાં અને કી બનાવો (પ્રીફિક્સ ttp_live_). પૂર્ણ સિક્રેટ બતાવવામાં આવે છે જ્યારે — તરત જ નકલ કરો.

2

મંજૂર કરેલો ટેમ્પ્લેટ પસંદ કરો

તમારા વર્કસ્પેસને ઓછામાં ઓછું એક મેટા-મંજૂર કરાયેલ ટેમ્પ્લેટની જરૂર છે (જુઓ ટેમ્પ્લેટ્સ). ટેમ્પ્લેટ્સ સીધા મેટાથી તાજા થાય છે.

3

ટેસ્ટ રિક્વેસ્ટ મોકલો

ઈન-એપનો ઉપયોગ કરો API ટેસ્ટર અથવા નીચે આપેલી રિક્વેસ્ટ. પ્રાપ્તિકારીએ તમારા નંબર પરથી ટેમ્પ્લેટ સંદેશાઓ મેળવવા માટે પસંદગી કરીને સ્વીકૃતિ આપી હોવી જોઈએ.

4

ડિલિવરી વેબહૂક ઉમેરો

તમારા HTTPS એન્ડપોઈન્ટ પર વેબહૂક પોઈન્ટ કરો, તે ઘટનાઓ પસંદ કરો જેનો તમે ધ્યાન રાખો છો, અને નિરીક્ષણ કરો વેબહૂક લોગ્સ વિતરણની પુષ્ટિ કરો.

પ્રામાણિકરણ

API સત્તાધિકૃત થાય છે પ્રત્યેક વર્કસ્પેસ API કીઓ સાથે, જે બેરર ટોકન તરીકે મોકલવામાં આવે છે. કીઓ બનાવવામાં આવે છે અને રદ કરવામાં આવે છે ડેવલપર → API કીઓ.

  • કી=start કરે છે ttp_live_ અને એક વર્કસ્પેસ સુધી મર્યાદિત છે.
  • દરેક ઇન્ટિગ્રેશન માટે અલગ કી બનાવો — દરેક કી પોતાનું ટ્રેક કરે છે last used સમયમતારા.
  • પૂર્ણ સિક્રેટ માત્ર રચના સમયે જ દર્શાવવામાં આવે છે; તે પછી પુનઃપ્રાપ્ત થઇ શકતું નથી. બદલે રદ કરો અને ફરીથી બનાવો.
  • ચાવી મોકલો Authorization હેડર: Authorization: Bearer ttp_live_…
તમારા API કી ક્યારેય પ્રદર્શિત ન કરો ક્લાઈન્ટ-સાઇડ કોડ, મોબાઇલ એપ્સ અથવા જાહેર રેપોઝિટોરીઝમાં. કીઓ માત્ર તમારા પોતાના સર્વર્સ અને સુરક્ષિત બેકએન્ડ માટે જ માટે છે.

સંદેશ મોકલો

તમારા વર્કસ્પેસમાં જોડાયેલા નંબરમાંથી એક ઓપ્ટ-ઇન રીસીપીન્ટને મંજૂરી આપવામાં આવેલી વોટ્સએપ ટેમ્પલેટ સંદેશા મોકલે છે.

POST https://v1.thetechpad.com/functions/v1/api-send

હેડર: Authorization: Bearer ttp_live_… · Content-Type: application/json

રિક્વેસ્ટ બોડી

ફીલ્ડપ્રકારવર્ણન
phoneNumberIdસ્ટ્રિંગતમારા વર્કસ્પેસમાં જોડાયેલા વોટ્સએપ નંબર (વોટ્સએપ નંબર પેજ) ની ID.
toસ્ટ્રિંગપ્રાપ્તકર્તાનો ફોન નંબર E.164 ફોર્મેટમાં, ઉદાહરણ તરીકે 15551234567.
template.nameસ્ટ્રિંગતમારા વર્કસ્પેસમાં મેટા-મંજુર ટેમ્પ્લેટનું નામ, ઉદાહરણ તરીકે 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ગ્રાહક તરફથી એક ઇનબાઉન્ડ સંદેશ આવ્યો.
  • એન્ડપોઈન્ટ્સ હોવા જોઈએ HTTPS અને ઈન્ટરનેટ પરથી પહોંચવાપાત્ર.
  • દરેક એન્ડપોઈન્ટ પસંદ કરેલી ઘટનાઓના ઉપસેટને સબ્સ્ક્રાઇબ કરે છે; દરેક ઘટના JSON પેલોડ સાથે ફાયર થાય છે જેમાં મેસેજ આઇડી અને સ્ટેટ્સ હોય છે.
  • ઉપયોગ કરો ટેસ્ટ એક એન્ડપોઈન્ટ પર નમૂના ડિલિવરી મોકલવા અને તમારો હેન્ડલર ચકાસવા માટે.
  • વિરામિત એન્ડપોઈન્ટ તેમની રૂપરેખાંકન રાખે છે પરંતુ ઘટનાઓ પ્રાપ્ત કરવાનું બંધ કરે છે.

દરની મર્યાદાઓ

મેસેજ તમારી યોજનાની પેકેજ દર પર મોકલવામાં આવે છે. વાસ્તવિક થ્રુપુટ ઓછું થઈ શકે છે જ્યારે મેટા મેસેજિંગ-ટિયર, ફોન-ક્વોલિટી અથવા અકાઉન્ટ-સ્તર મર્યાદાઓ લાગુ કરે છે. મેસેજો રહે છે સુરક્ષિત રીતે કતારબદ્ધ કરેલું ફેંકી ન પાડવાને બદલે.

યોજનાબદ્ધપ્રતિ મહિના API કોલ્સમૂળ મોકલવાની દર
સંબંધિત અભિયાન સ્ટાર્ટર—પ્રતિ મિનિટ 6 સંદેશાઓ સુધી
લૉન્ચ10,000પેકેજ દર
ગ્રોથ200,000પેકેજ દર
સ્કેલ2,000,000પેકેજ દર

દરેક વિનંતી તમારી API-કોલ ક્વોટામાં ગણવામાં આવે છે અને તેની સ્થિતિ કોડ અને સમયગાળા સાથે API લોગ્સમાં રેકોર્ડ કરવામાં આવે છે.

લોગ્સ અને દેખરેખ

ડેવલપર → લોગ્સ બે દૃશ્યો રાખે છે:

  • API લોગ્સ — દરેક API વિનંતી: પદ્ધતિ, એન્ડપૉઇન્ટ, HTTP સ્થિતિ, ઉપયોગમાં લેવાયેલ ટેમ્પલેટ અને સમયગાળો.
  • વેબહૂક લોગ્સ — દરેક વેબહૂક ડિલિવરી પ્રયત્ન અને તેનો પરિણામ.

ناکામ પ્રસારણને ડિબગ કરવા, વેબહૂક ડિલિવરીની પુષ્ટિ કરવા અને ઇન્ટિગ્રેશન્સની આખી ઓડિટ કરવા માટે તેનો ઉપયોગ કરો.

ભૂલસંબંધિત માહિતી

સફળ વિનંતીઓ નીચે આપેલ 2xx સ્થિતિ આપે છે. નિષ્ફળતાઓ non-2xx સ્થિતિ સાથેackson JSON બોડી આપે છે જે સમસ્યાનું વર્ણન કરે છે:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}
સ્થિતિઅર્થ
2xxવિનંતી સ્વીકૃત / પ્રક્રિયા કરવામાં આવી.
400ખરાબ વિનંતી — ખોટા અથવા મિસિંગ ફીલ્ડ્સ.
401એપીઆઈ કી ખૂટતી કે અમાન્ય.
403આ ક્રિયા અથવા કાર્યસ્થળ માટે કી માન્ય છે પરંતુ મંજૂર નથી.
404અજાણ્યો નંબર, ટેમ્પ્લેટ અથવા સંસાધન.
429દર મર્યાદા અથવા کوટા વધુ થઈ ગયો — પાછી પ્રયાસ પછી ફરી પ્રયત્ન કરો.
5xxપ્લેટફોર્મ ત્રુટિ — ફરી પ્રયત્ન કરો; API લોગ્સ અને સ્થિતિ પૃષ્ઠ તપાસો.

કન્સોલમાંથી API અજમાવો.

ઇન-એપ API ટેસ્ટર દરેક વિનંતી માટે curl, JavaScript અને PHP જનરેટ કરે છે.

અમારા સાથે ચેટ કરો