API & Webhooks

I have a scenario where I need to check wether the admin with a particular email exists then, assign a conversation to him. So, I want to check if an admin exists with that email.But as per API doc, I am unable to find any good api to do so, instead I have to hit Get All admins, and the filter the admin from it. Is it expected or any better solution?

Is there any way to create a conversation with delivery option of badge or snipped?I couldn't find something in the API docs.

I have a small piece of JS that attaches itself to anchor elements that link to an Intercom Article. When these anchors are clicked I intercept the event and call the `Intercom( 'showArticle', articleId )` API method. This works as expected. However, in local testing with a test environment those Article ID's are obviously not present. As expected, this fails and throws some errors in the console. This got me thinking about providing graceful fallback. Would it be possible to bubble these exceptions up to the caller so that I could catch and handle appropriately? In this case I would open the anchors link as if nothing happened. The goal here is to know about a failure with Intercom and have the opportunity to provide a graceful alternative for the user. This could mean that developers will need to handle exceptions bubbling from the API calls, a potentially disruptive change. Or, some kind of callback argument that can receive an error.

Hey there, I created a transactional message from an event and I would like to get the events custom data in my webhook, once the user answered to the conversation. From the api I don't see any way to get the event which triggered the conversation. Can you help me out here?Another option would be to listen for created events and trigger the conversation myself and add the meta data from the event as custom_attributes to the conversation. But how do I tell the API to send the conversation as snipped? Thanks upfront

Hi everyone, I would like to extract some conversations from intercom to gitlab through API. I could have most of the conversation information, but I can't get the information details in the right panel. What is the good endpoint to use ? Regards

We want to get different conversation stats when we receive a onAdminAssigned web hook. Since the statistics object is empty in the web hook payload itself, we have to make a REST request to api/conversations/{id} to get a full conversation payload.  We noticed that if we make this call immediately after getting a web hook, the statistics object will still be filled with zeroes. But if we wait for a couple of seconds before making that call, then we can get all the data we need. Could you pls provide an estimation of the delay (average and upper boundary) between a web hook being sent and the data being accessible via RES API? Is it possible to send conversation statistics in the web hook itself?

What is the actual rate limit? In the api it says 1000 per minute but when i make an api call it only returns 500 as max limit. Is there a procedure to ask for more calls? Does webhooks count as calls?

Keep getting this error: Email can't be sent right now as your app is being reviewed. We've emailed your app admin with more details. How to resolve this? error: when calling https://io.intercom.api/messages - Email can't be sent right now as your app is being reviewed. We've emailed your app admin with more details

Hi! For example. I've been trying to use query like this:data = { "query": { "field": "topics.topics.id", "operator": "=", "value": topic_id } }but there is a wrong search field. Is there any right search field for searching by topics?

I am making a call with this data: {  "message_type": "email",  "subject": "Hey",  "body": "Ponies, cute small horses or something more sinister?",  "template": "plain",  "from": {    "type": "admin",    "id": "61df30800add612e4d8e19dc"  },  "to": {    "type": "user",    "id": "61df30800add612e4d8e19dc"  }} and the response I get is as follows:{    "type": "error.list",    "request_id": "004ar6gmrkcj0msrhlg0",    "errors": [        {            "code": "not_found",            "message": "Resource Not Found"        }    ]} Can someone tell me why and what mistake I am making? Thanks Nat

Hi I'm trying to do something that I thought should be simple, but am struggling to find a solution and was wondering if anyone had any suggestions? Ultimately what I want to be able to do is: When a user of my app takes a particular action in the app, I want to trigger a message to be sent from an admin to the user saying something like "Thanks for the submission, we're looking into it and will get back to you...". I also need this conversation to appear in the admin's inbox, essentially as a "ticket" that they need to work on and get back to the user at a later date. I can't use the /conversations API to create a convo from admin to user because that direction isn't supported. (Conversations can only be created in the other direction, user -> admin).   I get a little further with the /messages API. It allows you to send a message from an admin to a user but the problem is that it doesn't create a conversation so nothing shows up in the a

Hello, I need to send a POST request with the intercom API and I'm not sure how to do it.  In particular, I need the contact id of the contact that has a specific company id (plus some other identifier that will help me pick the specific contact of the many that can exist in the company). I'm using this: https://developers.intercom.com/intercom-api-reference/reference/search-for-contacts/p> The question, therefore, is how do I do a POST query that queries not for a scalar as you would do to search eg for Minessota ("field": "location.region") but rather for a scalar within an array (as is the id within companies). Here's a typical (truncate) response I need to process: {  "type": "list",  "data": [    {      "type": "contact",      "id": "60a3b30b980bf6b7f155eb99",      "browser_language": "en",      "os": "OS X 10.15.7",      "location&quot

Hi friends - I work for a company that wants to gather admin names, their inbox status, and their last login data from the API. Last login is stored separately in event logs. Is it possible to get user object + last login in a single GET request? Basically, trying to simply the number of API calls we make. Making a call to the Admin is much better than making calls to both Admin + Event Audit Logs and doing surgery work to stitch those values together. Having Last Login data, account invited date, and account deleted date as properties of the user object would be very helpful.

Hello, We are using the intercom API and since the API has been upgraded to version 2, we are no longer able to retrieve data from UTMs linked to contacts (campaing / medium / source).Do you know why? Is an update planned?Thank you in advance for your feedback. Have a good day 👋

Hi Everyone, I'm trying to automate intercom with my CRM but unfortunately all of the fields are not coming through. My automation guy has put together a video outlining the problem and would really appreciate it if someone could help. Could be something on our end or a bug with the API Video Is linked Below https://www.loom.com/share/4817e63d3ae549e6b6ee966dc581adde

Hi, I want to use webhook to integrate Intercom with SurveyLab. I need to create a contact (email) in SurveyLab each time a conversation in Intercom is closed. How can I do that?

HelloWe are using Delighted to send our NPS sruvey, I would like to use Intercom to send more information in Deligthted. Does anyone know how to use Intercom and Zapier Webhook to create this trigger ? Thank you

Hello,We are getting user.deleted and company.creted events which are getting consumed in our application. Can you please confirm that the data within these events if missed out are also coming as part of API response or not? Meaninghttps://api.intercom.io/companies - does it give all the companies ? Meaning even If we miss company.created events, Can we get that data from this API in future?https://api.intercom.io/contacts - Does it gives the users/contacts which are deleted? Meaning If we miss the users.deleted events, can we get this information from this API in future?Let me know If you need any other information.Thanks,Sarwesh  

Hi,We successfully integrated the messages API to send emails through Intercom from our app. Now I'm wondering if there is any way to track these emails, like you can do on Intercom Web Interface messages:  Thanks in advance.

Hi All, We raised this with the partnership team and on GitHub itself but adding here for visibility. We (and others) pushed an enormous amount of fixes to this library in October last year and it still hasn't been released and as a result, the library doesn't fully support 2.0. https://github.com/intercom/intercom-php/p> Can we get some Intercom resources to finish what needs to be done and get it current again? We'd rather not have to branch it and run our own, only to have to merge back to Intercom if it's subsequently released.

I'm working on an application that integrates with Intercom, and some of my users would like to connect a single Intercom workspace to multiple organizations within my app for organization purposes. This is no problem on my end for the most part, however when it comes to handling webhook responses, it starts to become ambiguous. Previously I was using the `workspace_id` that in on all canvas webhooks, but now I have multiple entities that have that workspace ID, so I can't solely use that. I've considered adding metadata to the contacts themselves, but not all webhooks have a contact associated with them. The last thing I can think of is that they have different OAuth tokens, but webhook responses don't include that so I would have no way of matching it. And as far as I can tell, there's no way I can add some custom metadata to be included in a response per installation of my app. If anyone else has run into this or has any ideas, I'd love to hear!

Our issue is that we want to delete all of our customer inquiries +1 year - but doesn't seem possible? We have thousands of customer inquiries that we want to delete in our database, and want to automate this in the feature so that we only save the newest inquiries. https://developers.intercom.com/intercom-api-reference/reference#update-contact Thank you in advance for guidance and help regarding this issue.

var Intercom = require('intercom-client'); const client = new Intercom.Client({ token: my_token});client.users.list(function (err, d) { // err is an error response object, or null // d is a successful response object, or null try{ console.log('success') }catch(err){ console.error(err) } }); I need to fetch the users data from intercom to my server. I fellow the instruction https://github.com/intercom/intercom-node.But I don't know if I connect my workspace or not. And the second snap only return d as null.

We are building a platform for companies to train their teams and customers. With our product, clients (companies) can easily build their own academies and invite other users as learners. ​As admins, companies should be able to integrate their Intercom account to our platform, so that their users can contact them through Intercom Messenger. I'm using oAuth for other APIs, but, for this one, I would need their App Id - as far as I know, I cannot get this information through any API. Is that correct? Is there a way to connect their Intercom Account to a Messenger in our platform?​Thanks!

Hi,  I have an app that is installed via OAuth for 3rd party users. How do I tell what is their app id?  The rationale is that I'm using webhooks to listen to events for my 3rd party users, which I understand has an app_id within the payload. But I'm unable to map that app_id to which user that particular event is for as there doesn't seem to be anywhere else that provides that information upon OAuth?  Is there an API call that I can make to retrieve the app_id which an Access Token is tied to? Thanks!