// api docs

One API for WhatsApp & Telegram

Authenticate with an API key, point at a session, and send. Every endpoint works identically across both platforms.

1. Get an API key

Generate production, development, or read-only keys from Dashboard → API. Keys are scoped to your workspace.

2. Connect a session

Scan a QR for WhatsApp or complete the OTP flow for Telegram. Use the session_id in every call.

3. Send

Call send endpoints with your API key and session_id — messages and media go out through your connected account.

Example request
curl -X POST https://teleauto.com/api/send-message \
  -H "Authorization: Bearer wg_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "sess_8f2k1",
    "to": "+15551234567",
    "text": "Hello from TeleAuto 👋"
  }'
Response
{
  "ok": true,
  "message_id": "msg_a91xk2",
  "session_id": "sess_8f2k1",
  "status": "queued",
  "timestamp": "2026-07-18T09:12:44Z"
}

// reference

Endpoints

All endpoints accept and return JSON. Authenticate with Authorization: Bearer <api_key>.

POST/api/send-message

Send a text message from any connected session to a phone number, group, or channel.

POST/api/send-media

Send images, video, audio, voice notes, stickers, or documents with optional captions.

POST/api/send-contact

Share a contact card to any chat.

POST/api/send-location

Send a live or static location pin.

POST/api/send-buttons

Send interactive button and list messages for menus and quick replies.

POST/api/create-session

Provision a new WhatsApp or Telegram session and receive the QR / login flow.

POST/api/delete-session

Log out and remove a session, including its stored credentials.

GET/api/get-groups

List all groups, communities, and channels synced from a session.

GET/api/get-contacts

List contacts synced from a session, with phone, username, and chat_id.

GET/api/get-status

Check a session's connection state, device, battery, and last-seen.

POST/api/create-automation

Create a source → filter → transform → destination rule programmatically.

API access is included on every plan. Message volume is unlimited; API requests are rate-limited to 30 req/s per key to protect session health. Try every endpoint live in the API Playground inside your dashboard.