Teiwah API

How Teiwah works

Teiwah connects a WhatsApp number to your automation. The model is intentionally small:

flowchart LR
  WA[Incoming WhatsApp message] --> H[Teiwah webhook]
  H --> A[AI / n8n / your backend]
  A --> S[POST /messages]
  S --> WA2[WhatsApp reply]

Teiwah is reply-first

You can reply to anyone who messages you, and you can send to groups freely. But you cannot cold-message a person who hasn’t contacted you first — WhatsApp restricts accounts that start conversations from unofficial clients, so Teiwah blocks those sends with a 403. This is a hard WhatsApp limitation, not a Teiwah setting. If you need outbound marketing or notifications to new numbers, use the official WhatsApp Business API instead. See Trusted contacts.

Send messages

One endpoint, POST /messages, for text plus image, voice notes, audio, video, and documents — addressed by a single chatId.

Receive webhooks

Inbound WhatsApp events — 1:1 and group — are delivered to your webhook URL in the same chatId + text/media shape you send.

Session API keys

Each connected WhatsApp session has its own Bearer key, issued by the Teiwah dashboard.

Media by URL

Media is referenced by URL. Download inbound media on demand; send outbound media by URL or base64.

Get started

1. Create a session and connect WhatsApp in the Teiwah dashboard.
2. Copy the session API key.
3. Follow the HTTP Quickstart or install the TypeScript SDK.