create_simple_conversation
Create a simple bot auto-reply rule. When a customer sends a message matching the trigger keyword, the bot replies with the specified text. With "ask_contact" the reply asks for the customer's phone number or e-mail with a one-tap Messenger button (text only on other channels); "confirmation" is then sent once after the customer taps it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"hear": "<hear>",
"text": "<text>"
},
"name": "create_simple_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hear | Yes | Trigger keyword or phrase that activates this reply | |
| text | Yes | Reply message text to send when triggered. With "ask_contact" it is the question shown above the button and may be "" (= a standard question in the workspace language). | |
| agent_id | No | Optional moderator ID to auto-assign to the contact when triggered | |
| channels | No | Optional. Channels this rule replies on, e.g. ["instagram", "messenger"]. Omit or [] = every channel (default). "whatsapp" covers both official and unofficial WhatsApp numbers. On other channels the message falls through to the other rules, the default reply or the AI. | |
| label_id | No | Optional label ID to auto-assign to the contact when triggered | |
| ask_contact | No | Optional. Make the rule ask the customer for their phone number ("phone") or e-mail ("email") with one tap. On Facebook Messenger the reply text goes out with a quick-reply button pre-filled from the customer's Facebook profile (hidden by Meta when the profile has no such value); the tapped value is saved on the contact (e-mail field when empty, otherwise an internal note; phone always as an internal note). Instagram has no equivalent (Meta disabled it), so Instagram, WhatsApp and other channels receive the text only and the customer types the answer; a typed phone number / e-mail (within 24 hours of the ask) is saved the same way. "text" is optional with this argument: empty = a standard question. The rule must reply on Messenger (channels [] or including "messenger"). | |
| confirmation | No | Optional, with an "ask_contact" rule only. Confirmation message sent ONCE on the same channel and in the same conversation right after the customer taps the Messenger button and shares the phone number / e-mail, or — on any channel — types one in their next messages within 24 hours of the ask, e.g. "Thanks, we'll contact you by WhatsApp". While it is set, neither keyword rules nor the AI answer that message. Max 2000 characters. | |
| match_message | No | If true, requires exact match. If false, partial/fuzzy match (default: false) |