Skip to main content
Velor

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

  1. Paste the install snippet on your site, open the page, and send one message. Where →
  2. 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

  1. Create a key under Settings → API keys. It is shown once; copy it then. Grant only the scopes the integration needs. Where →
  2. 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>"
  3. 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

  1. Add a number from your own Twilio account, with your Deepgram and ElevenLabs keys. Where →
  2. 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.

Email

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

  1. Contact us to have your intake address provisioned. No go-live date is committed. Where →
  2. 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

  1. 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/inbound Where →
  2. 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/inbound 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.

WhatsApp

WhatsApp is built and tested in code but has not yet carried a customer conversation.

Before you start

  • Your own Twilio WhatsApp sender.

Steps

  1. On the Voice page add your Twilio WhatsApp sender as messaging-only.https://app.velorplatforms.com/api/whatsapp/inbound Where →
  2. In Twilio set the sender's inbound webhook to the URL below, then message it from WhatsApp.https://app.velorplatforms.com/api/whatsapp/inbound 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.

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

  1. Connect Slack with your bot token and signing secret, then enable Event Subscriptions on your Slack app. Where →
  2. 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.