Quickstart - ChatBridge

1. Create an API key

In the ChatBridge dashboard, go to Settings → API Keys → Create Key. Pick the scopes you need — a key defaults to read-only (every *.view scope) if you don’t pick any. The raw key is shown once; store it somewhere safe.

Keys are shown in full only at creation time. If you lose it, revoke it and create a new one — there’s no way to retrieve the raw value again.

2. Make your first call

Every request authenticates with a Bearer token:

curl https://api.algosmiths.com/api/v1/contacts/ \
  -H "Authorization: Bearer cb_live_..."

import requests

resp = requests.get(
    "https://api.algosmiths.com/api/v1/contacts/",
    headers={"Authorization": "Bearer cb_live_..."},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://api.algosmiths.com/api/v1/contacts/", {
  headers: { Authorization: "Bearer cb_live_..." },
});
const data = await resp.json();
console.log(data);

3. Send a message

curl -X POST https://api.algosmiths.com/api/v1/messages/ \
  -H "Authorization: Bearer cb_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "15550001234",
    "type": "text",
    "text": { "body": "Hey! Following up on your order." },
    "phone_number": "<your phone_number_id>"
  }'

Requires the chat.send_message scope. See Authentication for the full scope list, and the API Reference for every endpoint.

Outside the 24-hour customer service window, only template messages can be sent — the same rule Meta enforces, checked locally first so you get a clear error instead of an opaque one from Meta’s API.

Introduction Authentication

⌘I

​1. Create an API key

​2. Make your first call

​3. Send a message

1. Create an API key

2. Make your first call

3. Send a message