Quickstart

By the end of this page you will have created a credential, made an authenticated request, and received one signed webhook.

Note

Every snippet on this page is generated from the internal Talki API client, so it is executed on every release rather than proofread once. If a snippet is wrong, the API is wrong.

1. Create an API key

In the Talki dashboard, go to Impostazioni → Integrazioni → API and create a key. You will see the secret once. Talki stores only a hash of it and cannot show it to you again — if you lose it, revoke it and create another.

Keys are prefixed so they are recognisable in a log or a paste:

talki_live_…   production
talki_test_…   test mode

2. Make a request

curl https://api.talki.it/v1/calls \
  -H "Authorization: Bearer $TALKI_API_KEY" \
  -H "Talki-Version: 2026-10-01"

3. Receive a webhook

localhost will not work

Talki refuses to deliver to loopback, private, link-local and CGNAT addresses, and re-checks at delivery time — not just at registration. Point your endpoint at a public HTTPS tunnel (cloudflared, ngrok) while developing.

4. Verify the signature

Never trust an unverified payload. See Webhooks for the signing scheme and cross-language examples.