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
- WhatsApp (official API)
- Other channels
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.