Skip to main content

Monday.com integrations

Send Simplesat surveys from Monday.com items and get each response back on your board.

You can send a Simplesat survey from a Monday.com item as a link in an email. Connect Monday.com to Simplesat to get responses back on your board, as updates on items or as new items. The survey link works without connecting.

What the Monday.com integrations do

Simplesat's Monday.com page lists its integrations under Survey integrations and Ticket integrations. You switch each one on separately with Activate integration.

Integration

Listed under

What it does

Where it shows

Create an item when feedback is received

Survey integrations

Creates a new item from a response, in a group you choose

A new item on your board

Display feedback in an update

Ticket integrations

Posts the response as an update on its item

The item's updates

Pull item details

Ticket integrations

Adds details from the item to the response. Needs setup for your board

The response, in Simplesat

The Ticket integrations run only on surveys connected to Monday.com, and only for responses that came in with the Monday.com item ID. A survey is connected when its delivery method is External email embed with the Monday.com option, or when it's an Event-based or Web-embed survey with Connected service set to Monday.com.

Before you start

The Monday.com integrations are available on every Simplesat plan. To connect Monday.com and switch integrations on, you need the Manage integrations permission in Simplesat. Owner and Admin have it by default.

You connect with a Monday.com personal API token and the ID of one board. The token has the same access as the person it belongs to, and the updates and items the integrations add come from that person. Use the token of someone who can open the board and will keep that access. What a connected tool can read and write is set out in Integration security, permissions and data flow.

Connect Monday.com

  1. In Monday.com, click your profile picture, then Developers. Under API token, click Show and copy the token. Admins can also find it in Administration → Connections → Personal API token.

  2. Open the board in a web browser and copy its ID, which is the number after /boards/ in the address. The Monday.com desktop and mobile apps don't show it.

  3. In Simplesat, on the Integrations page, open Monday.com and click Authenticate.

  4. In Board ID, enter the board ID, and in API Key, the API token. Click Authenticate.

  5. When the page shows Authenticated with Monday.com, click Activate integration on each integration you want, then fill in its settings.

Before you rely on an integration, test it with a real item, as described in Testing an integration end to end.

Send surveys from Monday.com

  1. Create or open the survey and choose External email embed.

  2. Under Choose where to add your survey, choose Monday.com.

  3. On Publish, click Generate embed code.

  4. Choose Link and click Copy survey.

  5. In Monday.com, open an item on your board and go to its Emails & Activities view. If the item doesn't have one, add it with Add view.

  6. Click New email, write your message and paste the survey link. If Monday.com formats it as a link, remove the formatting so the address stays as plain text. Otherwise customers can't open it.

  7. To reuse the email, click Templates → Save draft as new template. You can then add the survey to any item's email by choosing the template.

The survey link carries Monday.com placeholders, which work as described in Placeholders and merge fields. {pulse.id} stands for the item's ID, which Simplesat saves as the response's ticket ID. {pulse.text} stands for the item's value in the column whose ID is text, which Simplesat saves as the customer email. Only some boards have a column with that ID.

The Ticket integrations work only on responses that arrive with the item's ID. Before you rely on them, email yourself the survey from an item and answer it. Wait at least five minutes, then check that Display feedback in an update has posted your response on that item.

Feedback as an update on the item

Display feedback in an update posts each response as an update on the Monday.com item the survey was sent from. The update names the customer, the sentiment and the survey, with links into Simplesat, and lists every question and answer.

Updates post no sooner than five minutes after a response arrives, as explained in Writing feedback back, and mapping the fields. If the response changes later, for example when the customer answers another question, another update is posted.

Under When should this integration run?, choose whether it posts every response from Monday.com surveys or only responses to the surveys you pick.

New items from feedback

Create an item when feedback is received turns feedback into a follow-up item, the way Creating a follow-up ticket from feedback describes. The new item goes on the board you connected, in the group you choose, and the response is posted on it as an update. The item is named New sentiment feedback from customer name on survey survey name, for example New positive feedback from Ana Lopez on survey Support CSAT.

To set it up:

  1. Click Activate integration on Create an item when feedback is received.

  2. In its Field mapping, enter the group's ID in Group ID. Use the ID, not the group's name. No item is created until Group ID holds the ID of a group on that board. You can fill other columns of the new item here too.

  3. Click Save.

To find the group's ID, use Monday.com's API playground:

  1. In Monday.com, click your profile picture, then Developers. The Developer Center opens in a new tab.

  2. Click API playground in the menu on the left.

  3. Run this query, with your board ID in place of 1234567890: query { boards(ids: 1234567890) { groups { title id } } }

It lists each group's title and ID. The query only reads, so it changes nothing on the board.

Under When should this integration run?, choose the surveys and the sentiments that create an item, for example only positive feedback.

The integration also runs when a response changes, which can create a second item for the same response.

Item details in Simplesat

Pull item details reads the response's Monday.com item and adds its details to the response, such as the subject, priority, type, customer, company and owner.

It has to be set up for your board, because the columns it reads depend on how the board is built. The Monday.com page says it requires setup by Simplesat support. Contact us and tell us which board it's for.

After setup, it runs as soon as a response arrives, on every response from Monday.com surveys. It replaces the details that came in with the survey link. See Attribution: linking feedback to tickets, customers and agents.

Change the API token or board

Reconnect to use a different board, a new API token or another Monday.com user. You also have to reconnect if the token is regenerated in Monday.com or its owner loses access to the board, because the integrations stop working even though the page still shows Authenticated with Monday.com.

  1. Note which integrations are on.

  2. Click Revoke access.

  3. Click Authenticate, enter the board ID and the new API token, and click Authenticate.

  4. Click Activate integration on each integration you noted.

Reconnecting keeps your integrations' settings, but they stay off until you activate them.

Heads up: Responses that arrive between Revoke access and reactivation aren't written to Monday.com.

Troubleshooting

Pull item details says it requires setup by Simplesat support

That's expected. The columns Pull item details reads depend on how your board is built, so it's set up for each board before it brings anything in. Contact us and tell us which board it's for. Display feedback in an update and Create an item when feedback is received don't need this setup.

Feedback doesn't show up as an update on my Monday.com items

Check that:

  • The survey is connected to Monday.com, and the response came in with the item's ID, which the survey link carries in {pulse.id}.

  • At least five minutes have passed since the response arrived. Updates don't post before then.

  • Display feedback in an update shows as active, and if you picked surveys, this survey is switched on under When should this integration run?.

  • If you clicked Revoke access and Authenticate, you also clicked Activate integration again.

If none of this explains it, send us the response's link.

No item is created when feedback comes in

Check that:

  • Group ID holds the ID of a group on the board you connected, not the group's name.

  • The survey and the response's sentiment are switched on under When should this integration run?.

  • The API token belongs to someone who can still open the board.

If none of this explains it, send us the response's link.

I see two updates or two new items for one response

Display feedback in an update and Create an item when feedback is received run when a response arrives and again when it changes, for example when the customer answers another question or changes their rating. Each run posts an update or creates an item.

My Monday.com integrations stopped working, but the page still says Authenticated with Monday.com

Simplesat doesn't recheck the connection after you connect. If the token was regenerated in Monday.com, or its owner lost access to the board, the integrations fail but the page still reads Authenticated with Monday.com. To fix it, click Revoke access, then Authenticate with a current token, then Activate integration on each integration you use. If the page shows an error message, Integration error messages and what they mean explains it.

FAQ

What does the Monday.com integration do?

It posts each response as an update on its item and can create a new item from feedback. Once it's set up for your board, it also adds item details to the response. You switch each of these on separately on the Monday.com page.

Can I create a Monday.com item only for positive feedback?

Yes. In Create an item when feedback is received, under When should this integration run?, switch on only the positive sentiment for your surveys.

Can I use more than one board?

There's one board per connection. New items go to the board whose ID you entered when you connected. To use another board, reconnect with its ID.

Do I need to connect Monday.com to send surveys?

No. The survey link works on its own. Connecting brings the feedback back to your board as updates, new items and item details.

Did this answer your question?