Practical guides
Telnyx & webhook setup
Give the carrier administrator the callback URLs and verify incoming voice and SMS.
Callback URLs for this deployment
A webhook is the callback address Telnyx uses to deliver call or messaging events to Korenact. Use the API hostname, not the public website, app, or documentation hostname.
| Telnyx destination | Korenact URL |
|---|---|
| Voice / Call Control application webhook | https://api.korenact.com/api/v1/webhooks/telnyx/voice |
| SMS / Messaging Profile webhook | https://api.korenact.com/api/v1/webhooks/telnyx/messaging |
If your deployment uses a different API domain, use its full HTTPS origin with the same paths. Share these addresses with the person managing your Telnyx account.
Administrator setup sequence
- Acquire an authorized Telnyx number with the required voice or messaging capabilities.
- Configure the voice Call Control application to deliver events to the voice webhook above and assign the number to the correct provider application.
- For SMS, configure the Messaging Profile webhook above and the number’s messaging setup.
- Install the Telnyx API credential, the applicable connection/profile identifiers, and the account’s webhook-verification public key in the deployment’s root environment file.
- Keep signature verification enabled. Production requires a valid base64 Ed25519 public key; the public key and API key have different purposes.
- Ensure the API is publicly reachable over HTTPS and the durable webhook worker is running.
- Register and assign the number in Korenact, activate the intended agent and channel, and run a real incoming test.
The provider administrator can find the public key in Telnyx Mission Control under Account Settings → Keys & Credentials → Public Key. See Telnyx’s webhook guidance. Portal labels may vary as Telnyx updates its interface.
Confirm delivery
- Call the configured line from an approved test number.
- Confirm the intended opening line and agent handling.
- Find the new record in Conversations and inspect its channel, agent, transcript, and trace.
- If SMS is included, send a separate test message and inspect its recorded handling.
- Run a staff-handoff test and verify the destination and follow-up process.
- If no record appears, ask the administrator to inspect provider webhook delivery, signature verification, number assignment, and worker processing.