Skip to main content
Use this when your system needs to reach one contact: an order confirmation, a delivery update, a support follow-up. Talqui finds or creates the contact, opens the conversation on the channel you choose and sends the first message. To send the same message to many contacts, use Campaigns instead.
1

Get an access token

Create an API credential in Settings → API credentials and exchange it for a token. Do this on your server: the secret must never reach a browser or app.
The token lasts 1 hour. Reuse it until then.
2

Find the channel connection

A conversation always goes out through a channel connected to your workspace (a WhatsApp number, an Instagram account…). In the Talqui web app, open Plugins, choose the channel and open the connection: its ID is the last part of the address, after /connections/. You also need the channel URN, listed in Session Start.
3

Open the conversation

Outside the 24-hour service window, WhatsApp only accepts an approved model as the first message, so send its campaignModelID.
sessionType decides who answers when the contact replies: auto (your automation), queued (the next available person) or manual with an operatorID (that operator).The answer carries the contact, the session and the first message. Keep the sessionID if your system needs to follow the conversation.
Phone numbers go in international format, digits only: 55 + area code + number for Brazil. See Phone number format.

Next steps

Session Start

Every field, the rules of each channel and who answers the conversation.

Manage the conversation

Assign it to an operator, transfer it to an inbox or close it through the API.