WhatsApp integration: WhatsAppConnection

Built in

Connect a WhatsApp Business number through SegmentStream's Meta app with Meta's Embedded Signup. A number already in the WhatsApp Business app keeps working there. Requests address the number and its account by alias, so code never handles their IDs.

Inside SegmentStream

Connected once, used everywhere.

Connections are declared in your repository and authorised in the console. The credentials stay with the platform; apps, pipelines, workflows and the agent use them under the same roles.

The console's connections page: Resend, Xero, Stripe, Supabase, LinkedIn and Telegram connections, each connected, with the key it is declared under in code — Connections declared in code and authorised here. The credentials stay with the platform, never in the repository.

What the connection reaches

Messages, read receipts and typing indicators from the connected number
Message templates of its account, and media
Optional contacts and chat history of a WhatsApp Business app number

Status: Built into the pipeline SDK
Connection class: WhatsAppConnection
Credential: Admin of the business portfolio that owns the number

Connect WhatsApp

Three steps, the same for every connection. The credential goes to the platform, never into the repository or pipeline code.

Declare it in connections/connections.py

connections/connections.py

from segmentstream.connections import WhatsAppConnection connections = (    WhatsAppConnection(key="whatsapp"),)

2
Deploy
```
$ segmentstream deploy
```
3
Connect
Open the connection in the console and sign in with an admin of the business portfolio that owns the number, or authorise it from the terminal. Tokens are refreshed by the platform; pipeline code never sees them.
```
$ segmentstream connection authorize whatsapp --open
```

Use it

Code asks for the connection by its key. The platform adds the credential on the way out.

pipeline/ingestion/…

import segmentstream as s with s.get_connection("whatsapp").get_http_client() as client:    response = client.post("/phone/messages", json={"messaging_product": "whatsapp", "to": "34600000000", "type": "text", "text": {"body": "Confirmed"}})    response.raise_for_status()

Or ask your agent

“Connect our WhatsApp Business number and send booking confirmations from it.”

Part of these solutions

Sales and CRM

Leads, deals and clients, shaped to how you sell

Support desk

Your shared inbox, triaged, on the customer record

More in Messaging & email

ResendBuilt inSend email from pipelines and ontology actions.TelegramBuilt inA bot for your team's chats, and one of the company agent's channels.SlackBuilt inA bot of your own Slack app: post to channels and read what it is part of.GmailBuilt inRead, search and send from one mailbox, such as support@.

All integrations →

Enterprise pilot

Want WhatsApp set up for you?

Our forward-deployed engineers build one solution on your data, in your own workspace, as code you own. Tell us what you run today and what you want; your note goes straight to our founder.

One solution, on your data, in your own workspace
First version live in two weeks
Parity proven before anything is switched off
Fixed scope and price, credited to your contract if you continue

Not ready for a pilot? Send the form anyway with your question. An engineer will reply, not a sales rep.

How the pilot works

NameWork email

CompanyWhat should the pilot cover?

Anything we should knowHow did you hear about us?

Goes to our founder’s inbox. No sales queue, no newsletter.

Connect what your company runs.

Start a pilot

Our engineers build the first version on your data in two weeks, at a fixed price.

Or build it yourself with your coding agent:

curl -fsSL https://segmentstream.com/install.sh | sh