API & Webhooks

Hello, We'd like to query via REST APIs all the Conversation SLAs for an account. We'd also like to know how much time is left/overdue with reference to an SLA for a single conversation. As of now, we can see that the conversational model has sla status but not details - https://developers.intercom.com/intercom-api-reference/reference/conversation-model/p> But, I don't seem to find a way to get the SLA details. Does Intercom provide a way to do that programatically? Regards

I created a canvas kit app for my teammates that looks up some customer details in our database and displays them in the inbox details panel, but I don't see any incoming data (like an access token) that I can use on our side to make sure the request is coming from intercom.

We would like to set the "Priority" or "SLA" attributes of conversations in particular. The reason is that we want to externalize the decision making of important vs non important conversations as soon as they come in. In the update conversation API, you can only update custom attributes. Right now we are only interested in Priority and SLA, but in the future we also might want to set tags or other fields. What we already tried: 1.Create an inbox rule that e.g. sets Priority if a custom attribute has a certain value. We set up a webhook to be notified when a new conversation comes in and set that custom attribute on the conversation through the API. Problem with this is that the inbox rule is triggered before we set the custom attribute. We also tried to call the /conversations/{id}/run_assignment_rules API but that only seems to trigger inbox rules which assign conversations. Even if we have an inbox rule that both assigns and sets the priority flag, only the assig

Hey everyone. I try to understand how I can connect a bot made on a different platform to the Intercom. Has anyone come across a similar case?

Hello everyone, I would like to know if I can list custom bots and resolution bots of my app by requesting the API. Thank's in advance.

I am using the Java SDK to update Intercom from my Java application. However I note that the Java SDK only supports v 1.3 of the intercom API. Is anybody using this SDK? Should I just use the REST API instead?

Have any way to send a button like demo bot sent:​​

For the intercom/intercom-react-native package found here (sorry, link button not working): https://github.com/intercom/intercom-react-native It says to use gradle 4.0.1 in the docs here:https://developers.intercom.com/installing-intercom/docs/react-native-installation/p> Does that mean that is the minimum version needed, or it has to be that version specifically? If specific, are there any plans to expand this to work with gradle 7.2? We use React Native 0.67.4 and it requires gradle 7.2. Also, can I suggest an "Issues" area on github? I think developers would really appreciate that. Thank you!

Does the "updated_at" field of a conversation gets updated whenever there is a new conversation part added to that conversation. I'd like to write a script which would query all conversations, check their "updated_at" fields and compare them to their previous values and if the values differ, the conclusion would be that a new conversation part was written for that conversation. Is this assumption valid? Then I would retrieve the parts only for the "updated" conversations.  Also a follow up to the question would be in relation to the hard limit set by retrieving conversation parts (500 max). How often is this limit reached? Is there a way to bypass this?

I wanted to get the date of a company first created and for some reason all of the companies' `created_at` date is set to unknown. According to docs its handled by Intercom: https://developers.intercom.com/intercom-api-reference/reference#company-model So I started passing down an UNIX timestamp to `remote_created_at` and instead of `remote_created_at` `created_at` started working. I tested 3 times with and without `remote_created_at` and I can confirm that `created_at` was only working when I passed a timestamp to `remote_created_at`.  Can someone help me to understand what's going on here? Thanks! Update: I fetched company data using the API and noticed that `created_at` timestamp is in-fact present on the company data. Its just not properly appearing on the Intercom company dashboard? And if I set `remote_created_at` then only the `created_at` will show up but not `remote_created_at`. This is weird behavior :S

I am migrating from tinycreative/react-native-intercom to intercom/intercom-react-native(3.0.5). I'm not using push notifications. The app builds in Xcode but is failing in Android. Below is a screen shot of the errors. When I go to the first one in the code, the full name is io.intercom.android.sdk.helpcenter.api.HelpCenterArticleSearchResult, but the error is cutting off at "api". It is the same for the rest. Why would it do that? I looked diligently online and couldn't find anyone with a similar problem. It seems weird that it is in node_modules. Anyone with a hunch as to why this might happen?

Hi, I'm using the API v2.5 to update a contact as per the docs: https://developers.intercom.com/intercom-api-reference/reference/update-contact/p> This works fine, but for some reason, when I try to update the contact's "avatar" field I've run into this weird issue: If I update with this URL it works fine: "https://img.icons8.com/material/344/user-male-circle--v1.pngquot;. But if I update with this URL, the update succeeds but the avatar field is set to null: "http://res.cloudinary.com/paind/image/upload/v1658396160/user-avatars/zyzlejwogq0oua4nmgwu.jpgquot; If I try a few different URLs, it seems that all my "res.cloudinary.com" URL strings result in your API setting a null value. My user avatars are hosted on Cloudinary, so this is a problem. I can't see why this is the case! Are you validating more than just string data type? String length? Excluding Cloudinary URLs for some reason? Please help! You should be able to recreate using a tes

How can I create a Contact with `utm_*` labels via API v2.5?

We are trying to create a contact with the role user, but on sending `external_id` in request, it's not getting returned in the response. Also it doesn't show up in the properties of the created contact in the dashboard. And using the search api with that `external_id` returns no results. Anything we might be doing wrong or some setting we have enable? Here's the request and response object:{ "role": "user", "external_id": "27", "email": "wash@serenity.io", "unsubscribed_from_emails": false, "custom_attributes": { "conversion_score": 0.98, "age_bucket": "0-14" } }{ "type": "contact", "id": "62b55ddacc687ae385777d76", "user_id": "f4e6fa26-a66f-44ad-a9c8-48aae2428a5d", "anonymous": true, "email": "wash@serenity.io",

Getting inconsistent responses using the unstable API version for the export endpoints. I also can't seem to parse the gzip response using any python library? What I am aiming towards is retrieving the chats between clients and admins up to 6 years in the past per client for compliance reasons. Is that possible?

Hi there! I'm a noob when it comes to API stuff, so just still trying to figure it all out.I'm attempting to setup a Zapier hook to pull a total number of conversations with a particular tag on them. Wondering if this is possible? I can see by this https://developers.intercom.com/intercom-api-reference/reference/conversation-counts I'm able to get the total count of conversations, but it doesn't specify if I'm able to also add a filter by tag. For some context that may or not be helpful, for customers that are affected by a bug we'll assign them the relevant bug tag. We can filter by this in reports, but if I can do it as an API call then I can get it into our Notion page which would be super handy. Finally, (and very optionally since it's probably not that related to Intercom lol) any basic advice on how I could implement an API call into Zapier? I tried to set one up and got a bit befuddled when it wanted tokens and auth stuff that I wasn't very famili

I know I can get the entire conversation which contains a list of all the conversation parts but that's overkill for my needs. I have a workflow automation tool that needs to check whether a particular conversation part has already been redacted and would like to get right to that data.

Essentially I have a production workspace and an app linked to it based off the 1.0 API version. I would like to make another app with the latest API version and more permissions and use it to retrieve the data from the same workspace. Will installing this app on the existing workspace break the other app or the workspace itself?

Hey there, I want to pass arbitrary data as custom_attributes to conversations. The update conversation endpoint succeeds but the data is not returned from the retrieve endpoint. Do you know why? Is this property working and if how? Is arbitrary data even allowed or do I have to define this data upfront?

How to send a message through the api to receive a reply from the robot

I am hitting the articles API and it returns the parent id for each article. Here is the article:https://support.tulip.co/en/articles/2280642-how-to-run-an-app-in-the-tulip-player/p>and its parent is:https://support.tulip.co/en/collections/2983157-introduction-getting-started-with-tulip#general-guides/p>which has an ID of 2983157, but when I call that document from the api I get a parent id of 3463139, which isnt a section or collection in my workspace.  Any idea what could be causing this? Pete

Hi, I'm building a custom support page listing articles using API. I saw a report called "Article engagement" with some statistics like "Views", "Conversations" and "Reactions". Is it possible to implement these statistics with API?

Apparently when I do a request for /search endpoints that has many results I receive the HTTP error 429.. e.g:body = { "query": {"field": "updated_at", "operator": ">", "value": 1656362751}, "sort": {"field": "updated_at", "order": "ascending"}, "pagination": {"per_page": 150,}, }   response = request.post(endpoint="https://api.intercom.io/conversations/searchquot;, payload=body)Even if it's only one day of search it leads to that 429 error...

Dear friends,  Do you guys know how can I connect my Intercom data into my MS Powerbi? I've searched and it looks like it is possible to get this done using the rest APIs provided by the Intercom but I'm not managing to access them, can someone help me on this?  Kind regards,

Hello, I am trying to merge contacts leads into users as follow: curl --location --request POST 'https://api.intercom.io/contacts/merge#39; \--header 'Authorization: Bearer toto=' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--data-raw '{  "from": "623f6320f06ce936269f7bd9",  "to": "6189c5687f416a8308a57a23"}'When I try and query for them individually like this: curl --location --request GET 'https://api.intercom.io/contacts/623f6320f06ce936269f7bd9#39; \--header 'Authorization: Bearer toto=' \--header 'Content-Type: application/json' \--header 'Accept: application/json' The API returns the contact (lead or user) that I want to merge.Also, same result when going through the platform:  https://app.intercom.com/a/apps/glsleifc/users/623f6320f06ce936269f7bd9/all-conversations/p> I get the proper profile with associated conversation. Yet, when I want t