Shiprocket + AI Calling: Trigger Automatic COD Confirmation Calls on Every Order

Log into your Vyora dashboard at app.vyora.ai, go to Settings → Integrations, and generate an API key. Copy it — you will use it as the X-API-KEY header in every request.

Also note your agent ID and from-number ID. You get these from:

• Agents → find your COD confirmation agent → copy the ID from the URL
• Settings → Numbers → copy the number ID you want calls to originate from

Store all three values as environment variables — do not put them in code:

VYORA_API_KEY=vya_live_xxxxxxxxxxxxxxxxxxxxxxxx
VYORA_COD_AGENT_ID=agent_xxxxxxxxxxxxxxxx
VYORA_FROM_NUMBER_ID=number_xxxxxxxxxx

Your webhook receiver is a single HTTP endpoint that Shiprocket POSTs to whenever order state changes. Filter for COD orders, then call the Vyora API.

const express = require('express')
const app = express()
app.use(express.json())

app.post('/webhook/shiprocket', async (req, res) => {
  // Acknowledge quickly — Shiprocket times out at 5 seconds
  res.json({ received: true })

  const order = req.body

  // Only process newly created COD orders
  if (order.payment_method !== 'COD') return
  if (order.status !== 'NEW') return

  const phone = order.customer_phone
  const name  = order.billing_customer_name || order.customer_name

  if (!phone || !name) {
    console.warn('Missing phone or name for order', order.order_id)
    return
  }

  try {
    const resp = await fetch(
      'https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual',
      {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
          'X-API-KEY': process.env.VYORA_API_KEY,
        },
        body: JSON.stringify({
          name:              name,
          mobile_number:     phone,
          agent_id:          process.env.VYORA_COD_AGENT_ID,
          from_number_id:    process.env.VYORA_FROM_NUMBER_ID,
          custom_args_values: {
            order_id:     String(order.order_id),
            product_name: order.products?.[0]?.name || 'your order',
            amount:       String(order.payment?.total_amount || ''),
          },
        }),
      }
    )

    const data = await resp.json()
    console.log('Call triggered:', data.call_id, 'for order', order.order_id)
  } catch (err) {
    console.error('Vyora call failed for order', order.order_id, err.message)
  }
})

app.listen(3000, () => console.log('Webhook listener on :3000'))

Deploy this on any host that gives you a public HTTPS URL — Render, Railway, a basic EC2 instance, or Vercel Serverless Functions all work. The endpoint just needs to be reachable from the internet.

You can also run it locally with ngrok while testing:

npx ngrok http 3000
# Copy the https://xxxx.ngrok.io URL — paste it in Shiprocket as your webhook URL

In your Shiprocket dashboard:

1. 1Go to Settings → API → Webhook
2. 2Click "Add Webhook" or "Configure"
3. 3Paste your endpoint URL (e.g. https://your-server.com/webhook/shiprocket)
4. 4Select event type: "Order Created" (the event that fires when a new order comes in)
5. 5Save. Shiprocket will send a test payload to confirm the endpoint is reachable.

Once saved, place a test COD order on your store. Check your server logs for the incoming payload. If you see the call trigger in Vyora's campaign dashboard within 60 seconds, the integration is live.

If you do not want to run a server, Zapier handles the webhook-to-API bridge without code. The free Zapier tier (100 tasks/month) is sufficient for low-order-volume stores; paid plans cover higher volumes.

1. 1

   Create a new Zap

   Trigger app: Webhooks by Zapier → "Catch Hook". Copy the webhook URL Zapier gives you.

2. 2

   Paste the Zapier URL into Shiprocket

   Settings → API → Webhook → add the Zapier URL as your endpoint. Fire a test COD order.

3. 3

   Map the fields

   Zapier shows you the sample payload. Identify: customer_phone, billing_customer_name, payment_method, order_id.

4. 4

   Add a Filter step

   Only continue if payment_method exactly matches "COD".

5. 5

   Action: Webhooks by Zapier → POST

   URL: https://prod-api.ringg.ai/ca/api/v0/calling/outbound/individual Headers: X-API-KEY → your Vyora key Body (JSON): map name, mobile_number, agent_id, from_number_id, custom_args_values