New to VisionScaper?
Start here
Help Center › Get your API keys › Get your Retell AI keys
Get your Retell AI keys
Create a Retell API key, mark it as the webhook key, and paste the details into the AI Receptionist screen.
On this page
Retell AI is the default voice-agent service for the AI Receptionist. VisionScaper has three Retell fields: Retell AI API key, Retell AI webhook secret, and Retell AI phone address (SIP).
Before you start
- A Retell AI account. Call rates are set by Retell; this guide does not quote them.
- WordPress administrator access.
- Know your webhook address: shown at the top of Settings → VisionScaper AI Receptionist, in the form
.../dreamscaper/v1/receptionist/webhook/ENGINE. For Retell, ENGINE isretell.
Steps
- Sign in to the Retell dashboard.
- Go to Settings (under System), then API Keys.
- Click Add, name the key, and save. Without Restrict permissions the key has full access; if you restrict it, it must be able to manage agents and make calls (Agent, Call, Phone and History groups). Which exact scopes VisionScaper needs was not verified.
- Select the key and click Set as Webhook Key. Only one key can be the webhook key.
- In WordPress go to Settings → VisionScaper AI Receptionist, Keys.
- Paste the key into Retell AI API key.
- For Retell AI webhook secret use the secret your Retell setup gives for signing webhooks. VisionScaper checks an HMAC-SHA256 signature in the
x-retell-signatureheader with this value. Which Retell value matches this was not verified in Retell’s docs; check their webhook documentation. - Retell AI phone address (SIP): paste the SIP address of your Retell phone number if you use the carrier hand-off. The field name is from VisionScaper; where Retell shows it was not verified.
- Save. A blank box keeps the saved value.
Tips
- Set the webhook address in Retell to the one shown on the VisionScaper screen, with
retellat the end. - Rotate by deleting the key in Retell, creating a new one, and pasting it.
If something goes wrong
- “The voice service isn’t connected yet”: the API key box is empty.
- Calls happen but nothing logs: the webhook secret or address is wrong.
Sources
- https://docs.retellai.com/accounts/manage-api-keys (read 2026-10-15)