ਡਿਵੈਲਪਰ ਦਸਤਾਵੇਜ਼

'ਤੇ ਬਣਾਓ ਟੈਕ ਪੈਡ API।

ਆਪਣੇ ਨਿੁਜੀ ਸਿਸਟਮ ਤੋਂ WhatsApp ਟੈਂਪਲੇਟ ਮੈਸੇਜ ਭੇਜੋ, webhook ਰਾਹੀਂ ਡਿਲਿਵਰੀ ਇਵੈਂਟ ਪ੍ਰਾਪਤ ਕਰੋ ਅਤੇ ਲੋਗਜ਼ ਵਿੱਚ ਹਰ ਰਿਕਵੇਸਟ ਦੀ ਨਿਗਰਾਨੀ ਕਰੋ।

ਮੁਫ਼ਤ ਵਰਡਪ੍ਰੈੱਸ ਪਲੱਗਇਨ

ਕੋਡ ਛੱਡੋ — ਇੱਕ ਕੁਨੈਕਟਰ ਪਲੱਗਇਨ ਇੰਸਟਾਲ ਕਰੋ।

ਉਹੀ ਵਟਸਐਪ ਬਿਜ਼ਨਸ ਏਪੀਆਈ, ਜੋ ਤੁਸੀਂ ਪਹਿਲਾਂ ਹੀ ਵਰਤ ਰਹੇ ਟੂਲਸ ਲਈ ਮੁਫ਼ਤ ਕੁਨੈਕਟਰ ਪਲੱਗਇਨ ਵਿੱਚ ਲਪੇਟਿਆ ਗਿਆ ਹੈ — ਹਰ ਫਾਰਮ, ਬੁਕਿੰਗ, ਇਵੈਂਟ ਅਤੇ ਸਟੋਰ ਪਲੇਟਫਾਰਮ ਸਿੱਧਾ ਤੁਹਾਡੇ ਵਟਸਐਪ ਨੂੰ ਭੇਜਦਾ ਹੈ। ਇੰਸਟਾਲ ਕਰੋ, ਆਪਣੇ ਇਮੇਲ ਨਾਲ ਕੁਨੈਕਟ ਕਰੋ, ਹੋ ਗਿਆ।

ਤੁਰੰਤ ਸ਼ੁਰੂ ਕਰੋ

ਚਾਰ ਕਦਮਾਂ ਵਿੱਚ ਸਿਫਰ ਤੋਂ ਇੱਕ ਵਟਸਐਪ ਸੁਨੇਹਾ ਭੇਜਿਆ ਗਿਆ। ਇੱਥੇ ਸਾਰਾ ਕੁਝ ਐਪ ਦੇ ਅੰਦਰ ਵੀ ਕੰਮ ਕਰਦਾ ਹੈ ਡਿਵੈਲਪਰ → ਓਵਰਵਿਊ ਪੇਜ, ਜੋ ਤੁਹਾਡੇ ਪ੍ਰਗਤੀ ਨੂੰ ਟਰੈਕ ਕਰਦਾ ਹੈ।

1

ਏਪੀਆਈ ਕੁੰਜੀ ਬਣਾਓ

ਖੋਲ੍ਹੋ ਡਿਵੈਲਪਰ → ਏਪੀਆਈ ਕੁੰਜੀਆਂ ਐਪ ਵਿੱਚ ਅਤੇ ਇੱਕ ਕੁੰਜੀ ਬਣਾਓ (ਪ੍ਰੀਫਿਕਸ ttp_live_). ਪੂਰਾ ਰਹੱਸ ਦਿਖਾਇਆ ਗਿਆ ਹੈ ਇੱਕ ਵਾਰੀ — ਇਸ ਨੂੰ ਤੁਰੰਤ ਕਾਪੀ ਕਰੋ।

2

ਇਕ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਟੈਂਪਲੇਟ ਚੁਣੋ

ਤੁਹਾਡੇ ਵਰਕਸਪੇਸ ਨੂੰ ਘੱਟੋ-ਘੱਟ ਇੱਕ ਮੈਟਾ-ਮਨਜ਼ੂਰ ਟੈਂਪਲੇਟ ਦੀ ਲੋੜ ਹੈ (ਵਿਖੋ ਟੈਂਪਲੇਟ). ਟੈਂਪਲੇਟ ਸਿੱਧਾ ਮੈਟਾ ਤੋਂ ਤਾਜ਼ਾ ਹੁੰਦੇ ਹਨ।

3

ਇੱਕ ਟੈਸਟ ਰਿਕਵੈਸਟ ਭੇਜੋ

ਐਪ ਵਿੱਚ ਵਰਤੋਂ ਕਰੋ API ਟੈਸਟ ਕਰਨ ਵਾਲਾ ਜਾਂ ਹੇਠਾਂ ਦਿੱਤੇ ਰਿਕਵੈਸਟ ਦਾ। ਪ੍ਰਾਪਤ ਕਰਨ ਵਾਲੇ ਨੇ ਤੁਹਾਡੇ ਨੰਬਰ ਤੋਂ ਟੈਂਪਲੇਟ ਸੁਨੇਹੇ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਸਹਿਮਤ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।

4

ਡਿਲਿਵਰੀ ਵੈਬਹੁੱਕ ਸ਼ਾਮਲ ਕਰੋ

ਇੱਕ ਵੈਬਹੁੱਕ ਨੂੰ ਤੁਹਾਡੇ HTTPS ਐਂਡਪੋਇੰਟ ਵੱਲ ਦਿਖਾਓ, ਉਹ ਘਟਨਾਵਾਂ ਚੁਣੋ ਜਿਨ੍ਹਾਂ ਦੀ ਤੁਹਾਨੂੰ ਪਰਵਾਹ ਹੈ, ਅਤੇ ਵੇਖੋ ਵੇਬਹੁੱਕ ਲੌਗ ਡਿਲੀਵਰੀ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ।

ਪ੍ਰਮਾਣਿਕਤਾ

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

ਰਿਕੁਐਸਟ ਬਾਡੀ

ਖੇਤਰਕਿਸਮਵੇਰਵਾ
phoneNumberIdstringਤੁਹਾਡੇ ਵਰਕਸਪੇਸ ਵਿੱਚ ਜੁੜੇ WhatsApp ਨੰਬਰ (WhatsApp ਨੰਬਰ ਪੰਨਾ) ਦੀ ID।
tostringਪ੍ਰਾਪਤਕਰਤਾ ਦਾ ਫ਼ੋਨ ਨੰਬਰ E.164 ਫਾਰਮੇਟ ਵਿੱਚ, ਜਿਵੇਂ ਕਿ 15551234567.
template.namestringਤੁਹਾਡੇ ਵਰਕਸਪੇਸ ਵਿੱਚ ਮੈਟਾ-ਮਨਜ਼ੂਰ ਟੈਂਪਲੇਟ ਦਾ ਨਾਮ, ਜਿਵੇਂ ਕਿ order_update.
template.languagestringਟੈਂਪਲੇਟ ਭਾਸ਼ਾ ਕੋਡ, ਜਿਵੇਂ ਕਿ 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ਇੱਕ ਸੁਨੇਹਾ ਵਟਸਐਪ ਪਲੇਟਫਾਰਮ ਦੁਆਰਾ ਮੰਨਿਆ ਗਿਆ ਅਤੇ ਭੇਜਿਆ ਗਿਆ।
message.deliveredਸੁਨੇਹਾ ਪ੍ਰਾਪਤਕਰਤਾ ਦੇ ਡਿਵਾਈਸ ਤੱਕ ਪਹੁੰਚ ਗਿਆ।
message.readਪ੍ਰਾਪਤਕਰਤਾ ਨੇ ਸੁਨੇਹਾ ਪੜ੍ਹ ਲਿਆ।
message.failedਸੁਨੇਹਾ ਫੇਲ੍ਹ ਹੋ ਗਿਆ (ਪਹੁੰਚਣਯੋਗ ਨਹੀਂ, ਟੈਂਪਲੇਟ ਰੱਦ, ਭੇਜਣ ਵਾਲੇ ਦੀ ਸੀਮਾ, …)।
message.receivedਗਾਹਕ ਵਲੋਂ ਇੱਕ ਆਗਮਨ ਸੁਨੇਹਾ ਆਇਆ।
  • ਐਂਡਪੌਇੰਟ ਹੋਣ ਲਾਜ਼ਮੀ ਹਨ HTTPS ਅਤੇ ਇੰਟਰਨੈੱਟ ਤੋਂ ਪਹੁੰਚਣਯੋਗ।
  • ਹਰ ਐਂਡਪੌਇੰਟ ਚੁਣੀ ਹੋਈ ਘਟਨਾਵਾਂ ਦੇ ਇੱਕ ਉਪਸੈੱਟ ਦੀ ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਕਰਦਾ ਹੈ; ਹਰ ਘਟਨਾ ਇੱਕ JSON ਪੇਲੋਡ ਨਾਲ ਚਲਦੀ ਹੈ ਜਿਸ ਵਿੱਚ ਸੁਨੇਹਾ ID ਅਤੇ ਸਥਿਤੀ ਸ਼ਾਮਲ ਹੁੰਦੀ ਹੈ।
  • ਵਰਤੋਂ ਕਰੋ ਟੈਸਟ ਕਿਸੇ ਐਂਡਪੌਇੰਟ 'ਤੇ ਨਮੂਨਾ ਡਿਲਿਵਰੀ ਭੇਜਣ ਅਤੇ ਆਪਣੇ ਹੈਂਡਲਰ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਲਈ।
  • ਰੁਕਿਆ ਹੋਇਆ ਐਂਡਪੌਇੰਟ ਆਪਣੀ ਵਿਵਸਥਾ ਨੂੰ ਸੰਭਾਲਦਾ ਹੈ ਪਰ ਘਟਨਾਵਾਂ ਪ੍ਰਾਪਤ ਕਰਨਾ ਬੰਦ ਕਰ ਦਿੰਦਾ ਹੈ।

ਰੇਟ ਸੀਮਾਵਾਂ

ਸੁਨੇਹੇ ਤੁਹਾਡੀ ਯੋਜਨਾ ਦੀ ਪੈਕੇਜ ਦਰ ਦੇ ਅਨੁਸਾਰ ਭੇਜੇ ਜਾਂਦੇ ਹਨ। ਜਦੋਂ ਮੇਟਾ ਮੈਸਜਿੰਗ-ਟੀਅਰ, ਫ਼ੋਨ ਗੁਣਵੱਤਾ ਜਾਂ ਖਾਤਾ-ਸਤਰ ਦੀਆਂ ਸੀਮਾਵਾਂ ਲਾਗੂ ਕਰਦਾ ਹੈ ਤਾਂ ਵਾਸਤਵਿਕ ਪ੍ਰਵਾਹ ਘੱਟ ਹੋ ਸਕਦਾ ਹੈ। ਸੁਨੇਹੇ ਰਹਿੰਦੇ ਹਨ ਸੁਰੱਖਿਅਤ ਤੌਰ 'ਤੇ ਕਤਾਰਬੱਧ ਫੇਕ ਦਿੱਤੇ ਜਾਣ ਦੇ ਬਜਾਏ।

ਯੋਜਨਾAPI ਕਾਲ / ਮਹੀਨਾਮੂਲ ਭੇਜਣ ਦਰ
ਕੈਂਪੇਨ ਸਟਾਰਟਰ—ਮਿੰਟ ਵਿੱਚ 6 ਤੱਕ ਸੁਨੇਹੇ
ਲਾਂਚ10,000ਪੈਕੇਜ ਦੀ ਕੀਮਤ
ਵਧਾਓ200,000ਪੈਕੇਜ ਦੀ ਕੀਮਤ
ਮਾਪ2,000,000ਪੈਕੇਜ ਦੀ ਕੀਮਤ

ਹਰ ਬੇਨਤੀ ਤੁਹਾਡੇ ਏਪੀਆਈ-ਕਾਲ ਕੋਟਾ ਵਿਚ ਸ਼ਾਮਲ ਹੁੰਦੀ ਹੈ ਅਤੇ ਇਸਦਾ ਸਥਿਤੀ ਕੋਡ ਅਤੇ ਸਮਾਂ ਦੇ ਨਾਲ ਏਪੀਆਈ ਲੌਗਾਂ ਵਿੱਚ ਦਰਜ ਹੁੰਦਾ ਹੈ।

ਲੌਗ ਅਤੇ ਨਿਗਰਾਨੀ

ਡਿਵੈਲਪਰ → ਲੌਗਸ ਦੋ ਵਿਚਾਰ ਰੱਖਦਾ ਹੈ:

  • ਏਪੀਆਈ ਲੌਗਸ — ਹਰ ਇੱਕ API ਬੇਨਤੀ: ਮੈਥਡ, ਐਂਡਪੋਇੰਟ, HTTP ਸਥਿਤੀ, ਵਰਤੇ ਗਿਆ ਟੈਂਪਲੇਟ ਅਤੇ ਸਮਾਂ.
  • ਵੇਬਹੁੱਕ ਲੌਗ — ਹਰ ਵੈੱਬਹੁਕ ਡਿਲੀਵਰੀ ਕੋਸ਼ਿਸ਼ ਅਤੇ ਇਸਦਾ ਨਤੀਜਾ।

ਫੇਲ ਹੋਈਆਂ ਭੇਜਣੀਆਂ ਨੂੰ ਡੀਬੱਗ ਕਰਨ ਲਈ, ਵੈੱਬਹੁਕ ਡਿਲੀਵਰੀ ਦੀ ਪੁਸ਼ਟੀ ਕਰਨ ਲਈ ਅਤੇ ਏਂਡ ਤੋਂ ਏਂਡ ਤੱਕ ਇੰਟੀਗ੍ਰੇਸ਼ਨਾਂ ਦਾ ਆਡੀਟ ਕਰਨ ਲਈ ਇਹਨਾਂ ਦੀ ਵਰਤੋਂ ਕਰੋ।

ਗਲਤੀਆਂ

ਸਫਲ ਬੇਨਤੀ ਇੱਕ 2xx ਸਥਿਤੀ ਵਾਪਸ ਕਰਦੀ ਹੈ। ਅਸਫਲਤਾਵਾਂ ਇੱਕ ਗੈਰ-2xx ਸਥਿਤੀ ਨਾਲ ਵਾਪਸ ਹੁੰਦੀਆਂ ਹਨ ਜਿਸਦੇ ਨਾਲ ਇੱਕ 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 ਤਿਆਰ ਕਰਦਾ ਹੈ।

ਸਾਡੇ ਨਾਲ ਗੱਲ ਕਰੋ