બનાવો ટેક પૅડ API પર.
તમારા પોતાના સિસ્ટમમાંથી વોટ્સએપ ટેમ્પલેટ સંદેશા મોકલો, વેબહૂક દ્વારા ડિલિવરી ઇવેન્ટ્સ પ્રાપ્ત કરો અને લોગ્સમાં દરેક વિનંતીનું મોનીટરીંગ કરો.
કોડ છોડો — કનેક્ટર પ્લગઇન ઇન્સ્ટોલ કરો.
સમાન WhatsApp બિઝનેસ API, જે તમારા પહેલાથી જ ઉપયોગમાં લેવાતા ટૂલ્સ માટે મફત કનેક્ટર પ્લગઇન્સમાં સમાવિષ્ટ છે — દરેક ફોર્મ, બુકિંગ, ઇવેન્ટ અને સ્ટોર પ્લેટફોર્મ સીધા તમારા WhatsApp પર મોકલે છે. ઇન્સ્ટોલ કરો, તમારા ઇમેલ સાથે કનેક્ટ કરો, પૂરુ!
ઝડપી પ્રારંભ
શૂન્ય પાસેથી ચાર પગલાંમાં વૉટ્સએપ સંદેશ પહોંચાડવો. અહીં બધું એપ્લિકેશનની અંદર પણ કાર્ય કરે છે ડેવલપર → સમીક્ષા પાનું, જે તમારી પ્રગતિને ટ્રેક કરે છે.
એપીઆઈ કી બનાવો
ઓપન ડેવલપર → API કીઓ એપમાં અને કી બનાવો (પ્રીફિક્સ ttp_live_). પૂર્ણ સિક્રેટ બતાવવામાં આવે છે જ્યારે — તરત જ નકલ કરો.
મંજૂર કરેલો ટેમ્પ્લેટ પસંદ કરો
તમારા વર્કસ્પેસને ઓછામાં ઓછું એક મેટા-મંજૂર કરાયેલ ટેમ્પ્લેટની જરૂર છે (જુઓ ટેમ્પ્લેટ્સ). ટેમ્પ્લેટ્સ સીધા મેટાથી તાજા થાય છે.
ટેસ્ટ રિક્વેસ્ટ મોકલો
ઈન-એપનો ઉપયોગ કરો API ટેસ્ટર અથવા નીચે આપેલી રિક્વેસ્ટ. પ્રાપ્તિકારીએ તમારા નંબર પરથી ટેમ્પ્લેટ સંદેશાઓ મેળવવા માટે પસંદગી કરીને સ્વીકૃતિ આપી હોવી જોઈએ.
ડિલિવરી વેબહૂક ઉમેરો
તમારા HTTPS એન્ડપોઈન્ટ પર વેબહૂક પોઈન્ટ કરો, તે ઘટનાઓ પસંદ કરો જેનો તમે ધ્યાન રાખો છો, અને નિરીક્ષણ કરો વેબહૂક લોગ્સ વિતરણની પુષ્ટિ કરો.
પ્રામાણિકરણ
API સત્તાધિકૃત થાય છે પ્રત્યેક વર્કસ્પેસ API કીઓ સાથે, જે બેરર ટોકન તરીકે મોકલવામાં આવે છે. કીઓ બનાવવામાં આવે છે અને રદ કરવામાં આવે છે ડેવલપર → API કીઓ.
- કી=start કરે છે
ttp_live_અને એક વર્કસ્પેસ સુધી મર્યાદિત છે. - દરેક ઇન્ટિગ્રેશન માટે અલગ કી બનાવો — દરેક કી પોતાનું ટ્રેક કરે છે
last usedસમયમતારા. - પૂર્ણ સિક્રેટ માત્ર રચના સમયે જ દર્શાવવામાં આવે છે; તે પછી પુનઃપ્રાપ્ત થઇ શકતું નથી. બદલે રદ કરો અને ફરીથી બનાવો.
- ચાવી મોકલો
Authorizationહેડર:Authorization: Bearer ttp_live_…
સંદેશ મોકલો
તમારા વર્કસ્પેસમાં જોડાયેલા નંબરમાંથી એક ઓપ્ટ-ઇન રીસીપીન્ટને મંજૂરી આપવામાં આવેલી વોટ્સએપ ટેમ્પલેટ સંદેશા મોકલે છે.
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.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 | ગ્રાહક તરફથી એક ઇનબાઉન્ડ સંદેશ આવ્યો. |
- એન્ડપોઈન્ટ્સ હોવા જોઈએ 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 જનરેટ કરે છે.