External Integrations Section - monday.com

Basics & Overview

1. What is the External Integrations Section - monday.com Block used for?

The monday.com Block allows your chatbot to interact with your monday.com account. It's a powerful tool for automating tasks like sending data to boards, reading data from them, and managing subitems directly from a chatbot conversation.

2. How does the monday.com Block help my business?

It helps you automate project and data management. Instead of manually entering information into monday.com, the chatbot can collect data from a user and send it to the correct board or item. You can also fetch information from a board to answer user questions.

3. What can I do with the monday.com Block?

The block offers three main actions:

• Send data to board: Create a new item on a board.

• Read data from board: Retrieve information from a board.

• Send data to subitem: Update a subitem on a board.

4. What do I need to get started with the monday.com Block?

You need to have an active monday.com account that has been integrated with your chatbot platform. You also need the IDs for the specific boards and items you want to interact with.

5. How do I choose the action I want the bot to perform using the monday.com Block?

You use the "Select Type" field to choose one of the three actions: send data to board, read data from board, or send data to subitem.

General Configuration

6. What is a "Board ID" and how do I find it for the monday.com Block?

A Board ID is a unique identifier for a specific monday.com board. You can find it in the URL of your board after boards/. For example, in the URL https://mycompany.monday.com/boards/1234567890, the board ID is 1234567890.

7. What is an "Item ID" in the context of the monday.com Block?

An Item ID is a unique ID for a specific item (a row or task) within your monday.com board. It is used to identify and manage individual items, especially when you need to send data to a subitem.

8. Why is "Select Integration" important in the monday.com Block?

This field allows you to select the specific monday.com account you've linked to your chatbot. This ensures the chatbot has the correct permissions to access your boards and items.

Action: Send Data to Board

9. How do I send new data to a monday.com board using the monday.com Block?

Choose the "send data to board" type. You will need to provide the Board ID and set up "Variable Mapping" to link your chatbot's data to the correct columns on your board.

10. What is "Variable Mapping" for the "Send Data to Board" action in the monday.com Block?

Variable Mapping is how you tell the chatbot which data to send to which column. You connect a Partner Variable (a monday.com column, like "Task Name") to a ChatMaxima Variable (like {{task_name_variable}}).

11. What kind of data can I send to a board using the monday.com Block?

You can send text, numbers, dates, and other data types as long as they are stored in a chatbot variable and mapped to a compatible monday.com column.

12. What happens after the data is sent using the monday.com Block?

After the block successfully sends the data, a new item will be created on your monday.com board with the information you provided. The chat flow will then continue to the next block.

Action: Read Data from Board

13. How do I read data from a monday.com board using the monday.com Block?

Choose the "read data from board" type. You'll need to provide the Board ID and then use "Variable Mapping" to specify the data you want to read.

14. How do "Select Column Name" and "Select Column Value" work in the monday.com Block?

This is how you filter the data you want to retrieve. You select a "Column Name" (e.g., "Status") and a "Column Value" (e.g., "Working on it"). The bot will then retrieve all items from the board that match this filter.

15. How do I use the data that is read from the board using the monday.com Block?

You must use the "Store the response in variable" field. This saves the retrieved data into a variable, which you can then use in a Text block to display the information to the user.

16. What happens if no data matches my filter using the monday.com Block?

If no items match your filter criteria, the block will not return any data. You can program your chatbot's flow to respond accordingly, such as by telling the user that the item was not found.

Action: Send Data to Subitem

17. What is a subitem in monday.com?

A subitem is a smaller, subordinate task or item that lives inside a main item on a board. It's used for breaking down a large task into smaller, more manageable steps.

18. How do I send data to a subitem using the monday.com Block?

Choose the "send data to subitem" type. You'll need to provide both the Board ID and the Item ID of the main item that contains the subitem you want to update.

19. Why do I need both a Board ID and an Item ID for this action in the monday.com Block?

You need the Board ID to locate the correct board and the Item ID to pinpoint the specific main item that the subitem belongs to. This ensures the data is sent to the correct location.

20. What is "Variable Mapping" for the "Send Data to Subitem" action in the monday.com Block?

Similar to sending data to a board, you will map your ChatMaxima Variables (your data) to the Partner Variables (the columns of the subitem) to update its information.

Practical Use Cases

21. How can the monday.com Block help me with task management?

You can create a chatbot that asks a team member for their task updates. The bot can then use this block to automatically send that update to the correct item or subitem on your team's project board.

22. How can the monday.com Block help with project tracking?

You can use the "read data from board" action to allow a user to check the status of a project. The bot asks for the project name and then retrieves the status from the board to share it with the user.

23. Can I use the monday.com Block for lead intake?

Yes. You can have a chatbot ask a new lead for their information and then use the "send data to board" action to create a new item on your "Leads" board with all their details.

Location & Tutorials

24. Where can I find the monday.com Block in the builder?

You can find the monday.com Block in the External Integrations section of your chatbot builder.

25. Where can I find a video tutorial for the monday.com Block?

You can find the video tutorial at:  https://chatmaxima.com/video-tutorials/integrating-mondaycom-block-in-chatmaxima/

Advanced Questions

26. How does the monday.com Block handle an incorrect Board ID or Item ID?

If the ID is incorrect, the block will fail to perform the action. The error can be caught by your chatbot's flow, allowing you to tell the user that an issue occurred.

27. What is the purpose of "Store the response in variable" in the monday.com Block?

This field allows you to save the result of the action, such as a confirmation message from monday.com or the ID of the new item that was created. You can use this data later in your flow.

28. How does the monday.com Block save me from writing code?

The block automates the complex API calls required to interact with monday.com. You simply configure the fields, and the platform handles the technical backend for you.

29. Can I use a variable to select the Board ID or Item ID in the monday.com Block?

Yes. You can use a variable in these fields to make your bot more dynamic, allowing it to work with different boards or items based on user input or a previous action.

30. Does the monday.com Block prevent duplicate items from being created?

This block primarily creates a new item each time it is used. You would need to use a "read data" action first to check if an item already exists before using the "send data" action.