'ਤੇ ਬਣਾਓ ਟੈਕ ਪੈਡ API।
ਆਪਣੇ ਨਿੁਜੀ ਸਿਸਟਮ ਤੋਂ WhatsApp ਟੈਂਪਲੇਟ ਮੈਸੇਜ ਭੇਜੋ, webhook ਰਾਹੀਂ ਡਿਲਿਵਰੀ ਇਵੈਂਟ ਪ੍ਰਾਪਤ ਕਰੋ ਅਤੇ ਲੋਗਜ਼ ਵਿੱਚ ਹਰ ਰਿਕਵੇਸਟ ਦੀ ਨਿਗਰਾਨੀ ਕਰੋ।
ਕੋਡ ਛੱਡੋ — ਇੱਕ ਕੁਨੈਕਟਰ ਪਲੱਗਇਨ ਇੰਸਟਾਲ ਕਰੋ।
ਉਹੀ ਵਟਸਐਪ ਬਿਜ਼ਨਸ ਏਪੀਆਈ, ਜੋ ਤੁਸੀਂ ਪਹਿਲਾਂ ਹੀ ਵਰਤ ਰਹੇ ਟੂਲਸ ਲਈ ਮੁਫ਼ਤ ਕੁਨੈਕਟਰ ਪਲੱਗਇਨ ਵਿੱਚ ਲਪੇਟਿਆ ਗਿਆ ਹੈ — ਹਰ ਫਾਰਮ, ਬੁਕਿੰਗ, ਇਵੈਂਟ ਅਤੇ ਸਟੋਰ ਪਲੇਟਫਾਰਮ ਸਿੱਧਾ ਤੁਹਾਡੇ ਵਟਸਐਪ ਨੂੰ ਭੇਜਦਾ ਹੈ। ਇੰਸਟਾਲ ਕਰੋ, ਆਪਣੇ ਇਮੇਲ ਨਾਲ ਕੁਨੈਕਟ ਕਰੋ, ਹੋ ਗਿਆ।
ਤੁਰੰਤ ਸ਼ੁਰੂ ਕਰੋ
ਚਾਰ ਕਦਮਾਂ ਵਿੱਚ ਸਿਫਰ ਤੋਂ ਇੱਕ ਵਟਸਐਪ ਸੁਨੇਹਾ ਭੇਜਿਆ ਗਿਆ। ਇੱਥੇ ਸਾਰਾ ਕੁਝ ਐਪ ਦੇ ਅੰਦਰ ਵੀ ਕੰਮ ਕਰਦਾ ਹੈ ਡਿਵੈਲਪਰ → ਓਵਰਵਿਊ ਪੇਜ, ਜੋ ਤੁਹਾਡੇ ਪ੍ਰਗਤੀ ਨੂੰ ਟਰੈਕ ਕਰਦਾ ਹੈ।
ਏਪੀਆਈ ਕੁੰਜੀ ਬਣਾਓ
ਖੋਲ੍ਹੋ ਡਿਵੈਲਪਰ → ਏਪੀਆਈ ਕੁੰਜੀਆਂ ਐਪ ਵਿੱਚ ਅਤੇ ਇੱਕ ਕੁੰਜੀ ਬਣਾਓ (ਪ੍ਰੀਫਿਕਸ ttp_live_). ਪੂਰਾ ਰਹੱਸ ਦਿਖਾਇਆ ਗਿਆ ਹੈ ਇੱਕ ਵਾਰੀ — ਇਸ ਨੂੰ ਤੁਰੰਤ ਕਾਪੀ ਕਰੋ।
ਇਕ ਮਨਜ਼ੂਰਸ਼ੁਦਾ ਟੈਂਪਲੇਟ ਚੁਣੋ
ਤੁਹਾਡੇ ਵਰਕਸਪੇਸ ਨੂੰ ਘੱਟੋ-ਘੱਟ ਇੱਕ ਮੈਟਾ-ਮਨਜ਼ੂਰ ਟੈਂਪਲੇਟ ਦੀ ਲੋੜ ਹੈ (ਵਿਖੋ ਟੈਂਪਲੇਟ). ਟੈਂਪਲੇਟ ਸਿੱਧਾ ਮੈਟਾ ਤੋਂ ਤਾਜ਼ਾ ਹੁੰਦੇ ਹਨ।
ਇੱਕ ਟੈਸਟ ਰਿਕਵੈਸਟ ਭੇਜੋ
ਐਪ ਵਿੱਚ ਵਰਤੋਂ ਕਰੋ API ਟੈਸਟ ਕਰਨ ਵਾਲਾ ਜਾਂ ਹੇਠਾਂ ਦਿੱਤੇ ਰਿਕਵੈਸਟ ਦਾ। ਪ੍ਰਾਪਤ ਕਰਨ ਵਾਲੇ ਨੇ ਤੁਹਾਡੇ ਨੰਬਰ ਤੋਂ ਟੈਂਪਲੇਟ ਸੁਨੇਹੇ ਪ੍ਰਾਪਤ ਕਰਨ ਲਈ ਸਹਿਮਤ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ।
ਡਿਲਿਵਰੀ ਵੈਬਹੁੱਕ ਸ਼ਾਮਲ ਕਰੋ
ਇੱਕ ਵੈਬਹੁੱਕ ਨੂੰ ਤੁਹਾਡੇ HTTPS ਐਂਡਪੋਇੰਟ ਵੱਲ ਦਿਖਾਓ, ਉਹ ਘਟਨਾਵਾਂ ਚੁਣੋ ਜਿਨ੍ਹਾਂ ਦੀ ਤੁਹਾਨੂੰ ਪਰਵਾਹ ਹੈ, ਅਤੇ ਵੇਖੋ ਵੇਬਹੁੱਕ ਲੌਗ ਡਿਲੀਵਰੀ ਦੀ ਪੁਸ਼ਟੀ ਕਰੋ।
ਪ੍ਰਮਾਣਿਕਤਾ
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 | string | ਤੁਹਾਡੇ ਵਰਕਸਪੇਸ ਵਿੱਚ ਜੁੜੇ WhatsApp ਨੰਬਰ (WhatsApp ਨੰਬਰ ਪੰਨਾ) ਦੀ ID। |
to | string | ਪ੍ਰਾਪਤਕਰਤਾ ਦਾ ਫ਼ੋਨ ਨੰਬਰ E.164 ਫਾਰਮੇਟ ਵਿੱਚ, ਜਿਵੇਂ ਕਿ 15551234567. |
template.name | string | ਤੁਹਾਡੇ ਵਰਕਸਪੇਸ ਵਿੱਚ ਮੈਟਾ-ਮਨਜ਼ੂਰ ਟੈਂਪਲੇਟ ਦਾ ਨਾਮ, ਜਿਵੇਂ ਕਿ order_update. |
template.language | string | ਟੈਂਪਲੇਟ ਭਾਸ਼ਾ ਕੋਡ, ਜਿਵੇਂ ਕਿ 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 | ਇੱਕ ਸੁਨੇਹਾ ਵਟਸਐਪ ਪਲੇਟਫਾਰਮ ਦੁਆਰਾ ਮੰਨਿਆ ਗਿਆ ਅਤੇ ਭੇਜਿਆ ਗਿਆ। |
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 ਤਿਆਰ ਕਰਦਾ ਹੈ।