How to test a telephony webhook

Verify the telephony webhook before going live. Testing confirms that channel settings are correct and calls will be processed properly.

Prerequisites

• A configured telephony channel
• Saved channel settings

When to use it

• After setting up a new telephony channel
• After changing field mapping in Advanced Config
• When you need to confirm the webhook works

Test via UI

Step 1: Open the channel form

1. Go to Settings → Bots
2. Select the bot you need
3. Open the Telephony tab
4. Open the channel for editing

Step 2: Run the test

1. Click Test
2. The system will:
   • Build a sample payload from your field mapping
   • Send the webhook to your Webhook URL
   • Show the test result

Step 3: Check the result

1. Check the test status:

   • Success — webhook processed, dialogue created
   • Error — read the error message

2. If the test succeeded:

   • Go to Operator Panel → Closed requests
   • Find the test dialogue with type Telephony
   • Confirm fields are filled correctly

Test via CURL

To test manually or from another service:

1. In the channel form, click Test
2. Copy the generated CURL command
3. Run it in a terminal
4. Expect {"status": "ok"} on success
5. Confirm the dialogue appears in Operator Panel

What to verify

• Dialogue created with type Telephony
• Phone numbers normalized to E.164
• Call status and duration are correct
• Recording URL saved if present in payload
• Transcript saved if present in payload

Common issues

Webhook not processed

• Channel is active
• Webhook URL and token match the channel
• Payload format matches Webhook format (JSON or form)

Fields not mapped

• Check field mapping in Advanced Config
• Field names match what the provider sends
• Use test webhook to inspect payload

Phone numbers not normalized

• Check default country code
• Check provider number format
• Verify caller_number / callee_number mapping

Related articles

• Configure telephony channel
• Configure Ringostat
• Configure UniTalk