Taalk Help Center

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

  1. Set the URL and Method as before.
  2. Click Customize request body.
  3. Click Insert default to start from the payload Taalk sends today, or write your own JSON.
  4. 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
  5. 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> sends true or false).
  • 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

  1. Open your Post-Call Form and find the multiple-choice question you use for the call result.
  2. Turn on DNC next to choices such as "Do NOT Call".
  3. 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.

  1. 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.
  2. Save.

When an operator submits the post-call form with that choice (or commits that disposition), Taalk automatically:

  • marks the campaign contact Taalk_Success (and dnc for 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": true in 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.