API & Webhooks

Hi there everyone, At the moment, under the hood, the Intercom messenger is sending requests with an anonymous_id field when it is tracking Leads on our website. Is there a way of updating this anonymous_id property ? At the moment when an event is tracked it makes an API call to POST https://api-iam.intercom.io/messenger/web/eventsand I can see part of the request payload:I believe this anonymous_id also corresponds to one of the Intercom tracking cookies: intercom-id-<APP_ID> and also the visitorId ? I'm trying to update the value of this anonymous_id but not sure how to accomplish this. Do I need to overwrite the value of the Intercom cookie in order to achieve this ? Some help would be much appreciated. Cheers

When I invoke the contact search API, I get the following error response. { "type": "error.list", "request_id": "0009s379b118psj1f100", "errors": [ { "code": "invalid_document", "message": "either_email_or_user_id_present validation failed" } ]} Does anyone know what has gone wrong here?

I am trying to search in conversations but using your example: I get a 400 "Query body must contain a query hash". When using contact search everything works fine

There are certain occasions I need to remove a user account in our platform but would love the option to keep that person's chat history with us in Intercom. They may no longer have a user ID in our own app, but their email would still remain the same. Right now, we archive the user in these scenarios, but that's not quite ideal because they just sort of "disappear" from Intercom. It would be great instead to just demote them from a user back into a lead. This would also allow for the ability to convert them back into a user should they rejoin our platform. Is something like this possible with through the API?

Hello, I have a user with conversations initiated by admins in our UI (with no user responses yet) as well as user-initiated conversations created via the Intercom API. When I query the individual conversations, the user's contact ID is associated with each conversation, as I would expect. When I query the `conversations/search` endpoint with a filter of `contact_ids = user_contact_id`, though, the only conversations returned are the ones initiated by the user.  Is that by design? I would expect that search for a conversation by contact_id would return ALL conversations that the user is associated with. If I'm going about this the wrong way or more detail is needed, please let me know. Thanks.

How do I access the next pages from of a search result. After the initial query to /conversations/search, with result spanning through multiple pages, how do I make the subsequent requests for the next pages?

Hi,I like to know how i retrieve data from a search when it has multiple pages.at the moment i do a search call and only can the data of the 1st page (150) conversations.

Hello, I am wondering if it is possible to work around having to make 1 request per company to receive their segment.list object. I just discovered the Scroll API addition, it is great. Am now receiving my companies in 11 requests instead of 987. Would love to have that functionality while making other requests. As it stands you need to provide a company id to receive a segment.list. Wondering if there is a way to perhaps provide a scroll page instead? Or better yet, add parameters to Scroll API requests to include full segment.list objects during Scroll API Companies requests. Thanks! 

Hello, I'm a Product Manager and I have a desire to have the ability for our WebApp to trigger an email notification to our users via intercom that the customer can then reply to and have the reply flow into our Intercom support inbox. What's the best way to do this?

I've noticed quite a few conversations return a null time_to_admin_reply in the conversation.statistics object even though there are agent replies to the conversation in Inbox.  My assumption is that the time_to_admin_reply key would return a duration in seconds of the time from when the conversation was created until the first admin (agent) responded. Is that not the case? If not, why would a conversation with admin replies return a null value?

A couple of months ago we built a workaround to export Messages from Intercom via the unstable Message Export endpoint. In the latest API, does the Search for Conversations return messages? In other words, if I did a search for yesterdays conversations, would it also return one-off / single messages from campaigns or manual messages to Contacts? https://developers.intercom.com/intercom-api-reference/reference#search-for-conversations/p>

If I create a bunch of contacts I'm hoping they won't be counted a people reached until they actually use intercom.

Hey all, I've been evaluating Intercom for what I feel like is a long while...my use case is different than many people here most likely...I don't have an app; just want to use Intercom for marketing & support for my website consulting clients.  The biggest thing I haven't figured out to do yet (without writing code...) is when a new lead signs up for my services (which I'm slowly moving to pre-paid packages that they pay for monthly), I have a Zapier zap that changes their user profile from a lead to a user in Intercom.  Does anyone know if that's possible to do with Zapier? I believe it is from the docs I've read, but any guidance would be awesome :)  Thank you all! DInos

If we use this API https://developers.intercom.com/intercom-api-reference/reference#list-data-attributes can we able to fetch any of the data attributes and pass that attribute value to a variable and then that variable need to be passed on to Watson. If yes could you please provide some guides/steps to achieve this?

How do I get conversations of a contact? There are methods for getting all conversations and all contacts? Should I loop through all conversations to filter the ones that belong to a given contact?

Hi, this is my first post, so go easy :) I'd like to reply to the last conversation using the api. The URL I'm calling is: https://api.intercom.io/conversations/last/reply/p> I'm using this as reference - https://developers.intercom.com/intercom-api-reference/reference#reply-to-a-conversation/p> The message body looks approximately like this: {  "message_type": "comment",  "type": "user",  "user_id": "usersemail@aferry.com",  "body": "Test message"} I've confirmed this user exists but I get this response: {    "type": "error.list",    "request_id": "000sdhmlsb3j8gk6qieg",    "errors": [        {            "code": "not_found",            "message": "User Not Found"        }    ]}Any ideas appreciated. I can't see what could be wrong.

Hi,Using webhooks to integrate Intercom with some 3rd party software.Subscribed for "conversation.admin.replied" topic. Everything works fine, until the "Article Inserter" is used.When message contains inserted article, the webhook data provided is: 'part_type': 'comment', 'body': '<p>[App: Article Inserter]</p>' So, there is no way to convert such webhook data to message in 3rd party software. We only know that some article was inserted. No url, no ID or title. It will be great if webhook data will contain information about inserted article.Hope it will get fixed someday. P.S. When we use "Insert Article" from Intercom mobile app (without Article Inserter app) - everything works fine, we get the article url in webhook data. But on desktop there is no such button without extra app...

I am also facing weird kind of issue. what happened in my scenario is that is as below (API V is 2.3).As per docs intercom save timestamp data in UTC formatwhen I pass the UTC timestamp to search API sometimes is does not return any result , but at the same time I pass the timestamp of my local region I got requested data . sometimes it happen vise-versain GET All CONTACT API - when requested sometimes data come in ASC order despite mention order=DESC key in query-params I am not sure what is happening at server but I am sure about date is correctly formatted from ISO string to UTC timestamp. Please kindly provide help.

Hi, I am creating a message using the intercom API. I'm able to send the request, but the recipient sees the sender of the email as: firstname.lastname@company.intercom-mail.com My question is that is it possible to configure intercom so that when the recipient sees the email address of the sender, it is the same as the actual email address of the admin? Rather than companyname.intercom-mail.com? The curl request is below: curl --location --request POST 'https://api.intercom.io/messages#39; \--header 'Authorization: {Bearer token}' \--header 'Content-Type: application/json' \--data-raw '{ "message_type": "email", "subject": "Email subject", "body": "The body of the text message goes here.", "template": "plain", "from": { "type": "admin", "id": "{admin_id}" },  "to": { "type&

Hi, I want to create a dashboard based on different filters from Intercom API. I want to have `session_count` and `signed_up_at` filters in Count API. I tried to figure out from the docs but couldn't find any. Please help on this. Any guidance is welcome

I created a custom attribute on Intercom and I would like to move it to our CRM (Zoho). How would it be visible on webhook?

Is it possible to send a in-app message to a visitor via api? Before they become a lead or a user. Or, is it possible to convert a visitor to a lead or a user via api then send them an in-app message? I'm trying to trigger an in-app message to a visitor after they fill out a form on my website. We are able to retrieve the Visitor ID using the provide JS and it looks something like this: IntercomVisitorId: [0dd41354-f701-4648-94ca-e24df88dadcc] But I don't know how to use this ID to target the visitor with an in-app message. Thanks!

Hi, I've mostly managed to navigate the Intercom API without issues. However, I'm struggling to create a note. (I'm using Python, but can replicate the issue with curl.) curl https://api.intercom.io/contacts/5f908d5b37fbb4bceed4c97a/note-X POST -H 'Authorization:Bearer *snip*' -H 'Accept:application/json' -d  { "body": "Shiny", "admin_id": "*snip*"} And I get a 404. Basically, https://api.intercom.io/contacts/lt;intercomid>/note doesn't seem to exist. If I change the URL to https://api.intercom.io/contacts/lt;intercomid>/notes then I get a different error - 400, "Body can't be nil" I am on the latest version (2.3) of the API. Can anyone help please? ThanksRobert

we can get workspace_id from request body. where we can get the wokspace name? any API available?

Api -https://api.intercom.io/auth/eagle/token Params- {"code":"", "client_id": "d0d273fc-d43c-4c2f-b4c9-1e22e43bcb01","client_secret":(VALUE HIDDEN)}in this api "code" what we need to pass in this param,