BD

API Settings

Integrate BdCalls with your store via REST API, Webhooks, and the WooCommerce plugin.

API Status:

Webhook is optional. If configured, BDCALLS will send call results to your store automatically.

API Key

Sent as x-api-key header

Never share your secret key in client-side code.

Rotating will invalidate the current key — any plugin or server using it must be updated.

Webhook

Receive real-time call results

Not configured

Used to sign callbacks via x-webhook-signature.

WooCommerce Plugin

Install on your WordPress store to auto-trigger voice confirmation calls.

Download Plugin

Replace clientsite.com with your store domain, then paste above in the Webhook URL field.

Setup Steps

  1. 1Download the plugin and upload it via WP Admin → Plugins → Add New → Upload, then activate.
  2. 2Open WooCommerce → BdCalls settings and paste your API Key.
  3. 3Paste the Webhook Secret generated above.
  4. 4Save settings — new orders will trigger voice confirmation calls automatically.

API Quickstart

Base URL: https://automation-api.bdcalls.com/api · Header: x-api-key

1. Create Call Request

POST https://automation-api.bdcalls.com/api/orders/create
Header: x-api-key: <your_api_key>

{
  "order_id": "ORD-58210",
  "store_id": "st_01",
  "customer": {
    "name": "Rumi Akter",
    "phone": "+8801711223344"
  },
  "amount": 2450,
  "currency": "BDT"
}

2. Webhook Result (Callback)

POST (Your Webhook URL)
{
  "event": "call.completed",
  "order_id": "ORD-58210",
  "call_uuid": "7f8a-4b2c-9e1d",
  "result": "confirmed",
  "dtmf_pressed": "1",
  "duration": 45,
  "timestamp": "2024-05-30T10:22:15Z"
}