Docs → Getting started
Getting started, channel by channel
The steps below are the ones your dashboard shows on Settings → Channels, in the same words. A channel only reads Live after a real conversation has arrived on it, so finish each guide by sending one.
Website chat widget
Before you start
- A Velor workspace with some knowledge added.
- Access to edit your site's HTML.
Steps
- Paste the install snippet on your site, open the page, and send one message. Where →
- Optionally restrict the widget to your domains under Settings → Widget. Where →
How you know it worked
Open Settings → Channels. The channel reads Live only after a real conversation has reached Velor on it; until then it shows Needs setup with the next step.
API
The public API has not yet carried a customer conversation. It is documented and tested, but treat it as available to build on rather than proven in production.
Before you start
- You are an owner or admin of the workspace (only they can manage API keys).
Steps
- Create a key under Settings → API keys. It is shown once; copy it then. Grant only the scopes the integration needs. Where →
- Send it as a Bearer token. For example, list conversations:
curl https://app.velorplatforms.com/api/v1/conversations \ -H "Authorization: Bearer velor_live_<your_key>"
- Browse every endpoint, its scopes and request and response examples in the API reference. Open →
How you know it worked
A 200 response with a `data` array. A 401 means the key is wrong or revoked; a 403 `insufficient_scope` means the key lacks the scope that endpoint needs (see API errors).
Voice (inbound phone)
Voice has carried real conversations. Do not rely on a specific answer latency; there is no latency commitment.
Before you start
- Your own Twilio account and number.
- Your own Deepgram and ElevenLabs accounts. Those providers bill you directly.
Steps
- Add a number from your own Twilio account, with your Deepgram and ElevenLabs keys. Where →
- Call the number from a phone and check that a conversation appears. Where →
How you know it worked
Open Settings → Channels. The channel reads Live only after a real conversation has reached Velor on it; until then it shows Needs setup with the next step.
Inbound email is not switched on for customers yet and no go-live date is committed. The second step applies once your address has been provisioned.
Before you start
- Email is not self-serve. Velor provisions your intake address with you.
Steps
- Contact us to have your intake address provisioned. No go-live date is committed. Where →
- Forward your support inbox to your intake address and send a test message. Where →
How you know it worked
Open Settings → Channels. The channel reads Live only after a real conversation has reached Velor on it; until then it shows Needs setup with the next step.
SMS
SMS is built and tested in code but has not yet carried a customer conversation.
Before you start
- Your own Twilio number. US numbers also need A2P 10DLC registration, which carriers gate and can take days.
Steps
- On the Voice page add your Twilio number as messaging-only. US numbers also need A2P 10DLC registration with Twilio.
https://app.velorplatforms.com/api/sms/inboundWhere → - In Twilio set the number's messaging webhook to the URL below, then text it from a real phone.
https://app.velorplatforms.com/api/sms/inboundWhere →
How you know it worked
Open Settings → Channels. The channel reads Live only after a real conversation has reached Velor on it; until then it shows Needs setup with the next step.
WhatsApp is built and tested in code but has not yet carried a customer conversation.
Before you start
- Your own Twilio WhatsApp sender.
Steps
- On the Voice page add your Twilio WhatsApp sender as messaging-only.
https://app.velorplatforms.com/api/whatsapp/inboundWhere → - In Twilio set the sender's inbound webhook to the URL below, then message it from WhatsApp.
https://app.velorplatforms.com/api/whatsapp/inboundWhere →
How you know it worked
Open Settings → Channels. The channel reads Live only after a real conversation has reached Velor on it; until then it shows Needs setup with the next step.
Slack
Slack is built and tested in code but has not yet carried a customer conversation.
Before you start
- A Slack app in your workspace, with your own bot token and signing secret.
Steps
- Connect Slack with your bot token and signing secret, then enable Event Subscriptions on your Slack app. Where →
- In your Slack app, set the Request URL to /api/integrations/slack/events, subscribe to message.channels, invite the bot to a channel, and post in it. Where →
How you know it worked
Open Settings → Channels. The channel reads Live only after a real conversation has reached Velor on it; until then it shows Needs setup with the next step.