Customize Taalk Phone Webhook Bodies and Mark Call Outcomes
You can now control exactly what Taalk Phone sends to your systems. Each API Integration (Inbound Lookup, Post-Call Webhook and In-Call Submit) can use your own JSON request body. Post-call form choices can also be marked as Do-Not-Call or Taalk Success.
Where to find it
- Company default: Manage Client → When using Taalk Phone.
- Per line: Operators → Routing → open a line → API Integrations. A line's URL and body override the company default.
Customize the request body
- Set the URL and Method as before.
- Click Customize request body.
- Click Insert default to start from the payload Taalk sends today, or write your own JSON.
- Click a variable to insert it at the cursor:
- Disposition:
<dispositionCode>,<disposition>,<dnc>,<taalkSuccess> - Form answers: one per question on the attached form, e.g.
<postcall.Disposition> - Call:
<phone>,<serverNumber>,<taskId>,<assignedTo>,<endedAt>, and more - Call params:
<params.your_field>for data from your Inbound Lookup or contact
- Disposition:
- Click Preview to see the body with sample data, then Save.
Example:
{
"lead_id": "<params.lead_id|unknown>",
"phone": "<phone>",
"status": "<postcall.Disposition>",
"do_not_call": <dnc>
}
Tips
- Put a variable inside quotes to send it as text (
"<phone>"). Leave it unquoted to keep its type (<dnc>sendstrueorfalse). - Call params aren't always available, because Taalk Phone doesn't always have contact data. Add a fallback with
|, e.g.<params.state|unknown>. - Leave the body blank to keep sending the default payload. GET requests send no body.
- Taalk won't save a body that isn't valid JSON.
Mark post-call choices as Do-Not-Call
- Open your Post-Call Form and find the multiple-choice question you use for the call result.
- Turn on DNC next to choices such as "Do NOT Call".
- Save.
When an operator picks that choice, Taalk adds the number to your Do-Not-Call list, marks the campaign contact as DNC, cancels pending callbacks for it, and sends "dnc": true in the post-call webhook. Your own system can also use <dnc> or the answer itself (e.g. <postcall.Disposition>) to update its records.
Mark outcomes as Taalk Success
Use Taalk Success to count outcomes such as a Live Transfer in your performance reports.
- Open your Post-Call Form and turn on Success next to choices like "Live Transfer". On a line's Dispositions list, use the Success column.
- Save.
When an operator submits the post-call form with that choice (or commits that disposition), Taalk automatically:
- marks the campaign contact
Taalk_Success(anddncfor DNC choices) - marks the call's session as Taalk Success, so it counts in campaign and agent performance
- counts it under Taalk Success in the Taalk Phone report, including a per-operator breakdown
- sends
"taalkSuccess": truein the post-call webhook (variable<taalkSuccess>)
Good to know
- Flags only turn on. Changing the disposition later won't clear Taalk Success or DNC on the contact.
- The contact is updated when the call belongs to a Taalk campaign. Otherwise only the call record and your DNC list are updated.