Wait for visitor messages
Waits for the next visitor message, for an agent without a server to receive webhooks.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Keep an eye on the website chat this afternoon and answer anyone who writes.
Your agent callschat_waitFree*
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"after": 48211,
"timeout_seconds": 25
}Use it when
The agent answers the chat live without a server: call it again and again, passing after.
- For messages pushed to a server as they arrive, use
notify_subscribe.
What it does
Listen to the website chat without a server: returns as soon as a visitor writes (or after timeout_seconds with no messages). Pass next_after from the previous call as after, and call again after call_again_in_seconds to keep listening (it is 60 when nobody is on the website, so the call answers at once); the first call also lists conversations still waiting for an answer. While you listen, the widget shows the business as online. A server should subscribe a webhook to chat.message_received instead.
What comes back
New visitor messages, each with its conversation_id, message_id, text, time, visitor and page, and next_after for the next call. The first call also lists the conversations waiting for an answer, and call_again_in_seconds: 60 when nobody is on the website (the call answered at once), else 0. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
after | integer | next_after from the last call. At least 0. |
timeout_seconds | integer | 0 to 25. Default: 25. |
The call
Over MCP, call chat_wait on https://api.conecto.chat/mcp/chat. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/chat_wait \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"after":48211,"timeout_seconds":25}'More Website chat tools
All 9 tools- Set up the website chat
chat_setupCreates or changes the business's website chat widget and who answers it, and returns the snippet for the website.$0.001 a call - Get the website chat setup
chat_get_setupThe website chat's settings, its embed snippet, how messages reach the agent and this month's cost.Free* - List chat conversations
chat_list_conversationsThe website chat and email conversations, newest activity first, with who it is and the last message.Free* - Get a chat conversation
chat_get_conversationOne conversation with all its messages, from the visitor and from the business.Free* - Show that you are typing
chat_typingShows the visitor that the business is typing, for about 8 seconds.Free - Reply in a chat
chat_replyAnswers a website visitor as the business, with product cards, images or buttons if you like.Free - Turn a chat into a ticket
chat_create_ticketOpens a help desk ticket from a chat that needs follow-up by email, with the chat so far as the request.$0.01 a call - Close or reopen a chat
chat_closeCloses a conversation once it is handled, or opens it again.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md