Authentication (OTP) Templates

Authentication templates always have a single body variable with param_name: 1. Pass the OTP code as variables.body["1"].


POST /v1/whatsapp/send


// expected_variables.body:
// [ { "param_name": 1, "example": "123456" } ]

cURL


curl -X POST https://api.bahasha.app/v1/whatsapp/send \
  -H "Authorization: Bearer bh_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+254700000000",
    "phone_number_id": "123456789",
    "template_name": "your_otp_template",
    "language_code": "en_US",
    "variables": {
      "body": { "1": "847291" }
    }
  }'

JavaScript


const otp = generateOtp(); // your OTP generation logic
 
const response = await fetch("https://api.bahasha.app/v1/whatsapp/send", {
  method: "POST",
  headers: {
    "Authorization": "Bearer bh_live_xxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+254700000000",
    phone_number_id: "123456789",
    template_name: "your_otp_template",
    language_code: "en_US",
    variables: {
      body: { "1": otp },
    },
  }),
});
const { message_id } = await response.json();

Python


import requests, secrets
 
otp = str(secrets.randbelow(900000) + 100000)  # 6-digit OTP
 
response = requests.post(
    "https://api.bahasha.app/v1/whatsapp/send",
    headers={"Authorization": "Bearer bh_live_xxxxxxxxxxxx"},
    json={
        "to": "+254700000000",
        "phone_number_id": "123456789",
        "template_name": "your_otp_template",
        "language_code": "en_US",
        "variables": {"body": {"1": otp}},
    },
)
print(response.json()["message_id"])

Use webhooks to watch for sent and delivery events for OTP messages.