Chatbot conversations consist of passages and logic:
- A passage is the building block of your chatbot. Each passage contains content or scripts that address a single question or need from the chatbot user.
- Logic is a decision point in the conversation where the chatbot will start a certain passage or run a specific script based on conditions like a variable value.
On the conversation canvas, passages are represented as squares, and logic are represented as purple diamonds. Both passage and logic have:
- A name to briefly describe them.
If the name is too long to display, you can hover over the passage or logic to read the full name. - A menu with options to:
- Duplicate
- Move to another conversation
- Delete
- Copy the ID for use with scripts
- Preview in Messenger
- Testin Testbot
- An icon on the bottom corner indicating publication status or errors:
- No colour or icon: published and no changes since publication.
- Blue with a circle: published but with unpublished changes, as in the list of version changes.
- Green with a plus: new and has never been published, as in the list of version changes.
- Red with a cross: critical errors that will prevent your chatbot from publishing a version.
Hover over the passage or logic for a detailed error message.
- Icons to indicate the passage or logic content.
Passages and logic may also be highlighted to indicate their status:
- A red highlight indicates the passage or logic is disabled.
- A green highlight indicates the passage or logic is an entry point.
An entry point is where a chatbot user may start interacting with your chatbot. Passages or logic that are entry points can't be moved or deleted. - A blue highlight indicates the passage or logic matches your search terms.
![]()
Content preview
Passages have:
- A preview of what message bubbles the chatbot sends in that passage, such as text, buttons, a script, or a combination of elements.
- Three slots on the right indicating whether the passage has inbound global questions, inbound conversation questions, or outbound questions. The letter code in each indicates if the questions are keywords, NLP, or a mix of both.
- An icon at the bottom right indicating how the chatbot user is expected to respond: asking a question, pressing a button or quick reply, sending requested information, or no response. The icon might also indicate that the chatbot hands over to a human at the end of the passage, or runs a script after the chatbot user has responded.
Logic have a letter code on the bottom half of the diamond indicating that the logic has Keyword, NLP, or a mix of both keyword and NLP inbound questions. Logic does not have message content or outbound questions or expect a response from the chatbot user.
Working with your team
You can see who else is viewing this conversation flow by looking for their avatar in the top left of the canvas. If someone on your team is editing a passage or logic, you'll see their avatar below that passage or logic in the canvas.