API & Webhooks

I am using Java SDK to send events to intercom. It works on local machine, but now AWS. I get below exceptionjava.io.FileNotFoundException: https://api.intercom.io//events java.io.FileNotFoundException:https://api.intercom.io//events atjava.base/sun.net.www.protocol.http.HttpURLConnection.getInputStream0(HttpURLConnection.java:1920) at java.base/sun.net.www.protocol.http.HttpURLConnection.getInputStream(HttpURLConnection.java:1520) at java.base/java.net.HttpURLConnection.getResponseCode(HttpURLConnection.java:527) at java.base/sun.net.www.protocol.https.HttpsURLConnectionImpl.getResponseCode(HttpsURLConnectionImpl.java:334) at io.intercom.api.HttpClient.runRequest(HttpClient.java:151) at io.intercom.api.HttpClient.executeHttpMethod(HttpClient.java:110) at io.intercom.api.HttpClient.post(HttpClient.java:100) at io.intercom.api.DataResource.create(DataResource.java:25) at io.intercom.api.Event.create(Event.java:35)  

We have our product running for a couple years now. There's a lot of users. When we started with intercom there either wasn't any option for supporting push notifications or we just didn't find it enticing enough. Now we would like to enable push notifications in intercom. We have thousands of push notification tokens in our DB that we use in our product. Is there any option to use those tokens and just synchronize them to the users in Intercom or is the only possible option to use the iOS SDK in our app?

Hi Team, I'm trying to create a webhook for my app that having OAuth authentication (i.e. Intercom users can install my app on their account/workspace). In my app, users can create separate functions to be executed for each type of intercom notification topic e.g. 'contact.created' topic triggers function1 and 'company.created' topic triggers function2 ...etc. So for example, if user1 creates 2 different functions for 'contact.created' & 'company.created' and another user2 creates few more functions for different notification topics for that user's account/workspace.  With webhooks how do we distinguish from which user or workspace the notification is generated? Webhook json payload does not seem having any field that allowing me to uniquely identify user/account/workspace where the event occur? or am I missing something?thanks

Intercom's agent chat interface has action messages that are displayed differently, i.e. in the center of the agent's chat window. For example the "You assigned this conversation to yourself 1h ago" notification. I would like to send this through the API, is this possible? Is there a conversation message type that we can use for this or recommended html body formatting type? I have tried applying the formatting that is applied in the agent's chat screen to my message body and this did not work.

When I create a conversation using the API, and run assignment for this conversation either using the run_assignment_rules route or just assign it to a department, this does not take into consideration the office hours. Is this an intercom API limitation or is there something I am missing in my workspace config?

I'm creating wallboard for my client where I have to show how many "total chat today"? How can I fetch that? Please help.

The documentation for Creating a Conversation (sample response below) says that the ID representing the conversation is returned as a response. (conversation_id). However, when testing this, I'm only seeing the ID of the specific message - rather than the conversation_id of the conversation.... only type through message are returned. HTTP/1.1 200 OK{ "type": "user_message", "id": "2001", "created_at": 1401917202, "body" : "Hey, is the new thing in stock?", "message_type": "inapp", "conversation_id": "36000324324"} How can I find the ID of the conversation?   

Currently, I add the "meta-data" of the content being reviewed as a note into the conversation. But it would be a lot better if I could move this into the sidebar. Is there a way to add meta-data into a conversation that is then automatically shown in the sidebar? Also it is a bit challenging since for various reasons customers might have multiple user IDs on intercom. We add all users (and their external ID) via Javascript on every request. But how do we best sync the intercom user ID back to our system, since the Intercom API always wants us to use their IDs and not our external IDs (which would be way more convenient).  Semi-related it is not very nice that we have to use IDs for things like teams and not just string identifier. This means we need to either fetch and cache this information or configure it, which is cumbersome, especially between the test and production intercom instances.

We use Intercom's Oauth to get the access token for our users(Dashworks). Recently we are getting 401s and user's had to re login(Access token was changed). Do the token's expire by design and is there a way to refresh them?

Hello Team, I am using intercom webhook events to process the changes to objects. However, there is no topic for contact.updated or company.updated, https://developers.intercom.com/building-apps/docs/webhook-model Without these topics, we have to run jobs to fetch the updates. Is there an alternate solution, or i am missing something

I am using contact/search API with query using created_at filter. My question is, when I query the record using created_at filter for newly created record and I am not getting records. but when I query the record using previous day UNIX timestamp for newly created_at record, I am able to get record or sometimes I am not able to get records on both scenarios Is there any issue on API side ? Below is my query Endpoint: https://api.intercom.io/contacts/search /p>method: POSTBODY -> JSON format{  "query":{        "field": "created_at",        "operator": "=",        "value": "1619049600"  }}  docs linkhttps://developers.intercom.com/intercom-api-reference/reference#search-for-contacts/p>

I am trying to implement the Intercom API into my server side .NET Core application. I am using System.Net.Http Library to set this call up. The issue that I am running into is when I try to create a conversation using my code below I keep getting an error response stating "User Not Found" even though the same body being passed in works perfectly fine POSTMAN. Is there anything I am doing wrong here? ---------------------------------------------------------------------------------    public class Create   {       public FromObj From { get; set; }       public string Subject { get; set; }       public string Body { get; set; }   }    public class FromObj   {       public string Type { get; set; }       public string Id { get; set; }   } public async Task CreateConversationBlah()       {           using (var client = HttpClient)           {               client.DefaultRequestHeaders.Authorization =                   new AuthenticationHeaderValue("Bearer", "&lt

So I have been following the document related to intercom api and was able to add a new conversation with body using the api. However, I am also trying to assign a conversation title along with some of my tags during the creation process but it does not seem to be reading those properties during creation. I tried the PUT endpoint after the conversation was created to update those fields but they do not seem to make any updates either. Please let me know what the correct way to accomplish this?! Thanks in advance.

As far as I understand the "external_id" represent the "User id" we see in a user's or lead's profile.Is it possible to change a contact's "external_id" with a "PUT /contacts/<id>"?I tried but it doesn't seem to work. I can change other properties like "email" just fine, but "external_id" doesn't change in the contact model in the response to the call, despite the status code being "200 OK".Is there any other way to change the "user_id" of a contact otherwise?

Hello! How's it going? 😎  According to this doc: https://developers.intercom.com/installing-intercom/docs/intercom-javascript you can start out a tour, using, for example: Intercom('startTour', 123); Also, you can open a message with a pre-populated text, like this: Intercom('showNewMessage', 'pre-populated content'); Is it possible to open a post from a JavaScript call in a similar way? Thanks! 

Building a custom messenger UI on top of the Intercom API. Are there developers with similar experience to share feedback? Limitations and difficulties?

Documentation in many places is not updated and it is not aligned with the code snippets. For example, the section for Custom attributes:https://developers.intercom.com/intercom-api-reference/reference#section-request-body-parameters/p>In request body parameters, 'model' property is understood as a mandatory one. On the other hand, in CURL code snippet, it is missing, instead there is another one, not mentioned in a description, 'company'. "data_type" property in the code snippet has "options" value, which is not listed in the documentation on the left side. Also, phrase "Provide a set of hashes..." sounds odd, hash is mostly understood as non-readable representation of the input value, got from the transformation of the input value. From the context we can get a feeling that we just need to provide a set of text key/value pairs. Overall, the right working code can be get only from the test and trials, which is not very efficient, and can

I did not find it in the documentation, but it seems that we can not add values to our custom attributes in UI Admin?I tested it with Intercom 2.3:create a custom attribute using https://api.intercom.io/data_attributes/li>I had ui_writable property set to true in my request. I also tried to modify the attribute by sending "update request" with ui_writable = truestill in the UI I can not assign any value to the new attribute. Could you please help with that? Is it a limitation of custom attributes? Can they be edited in UI?

I'm making an API call to list conversations using the example on the right here: https://developers.intercom.com/intercom-api-reference/reference#list-conversations/p> But unlike the example response, the response I am getting doesn't contain statistics for the conversation. Am I doing something wrong?  Note that I already removed the '\' from the beginning of the example request which I think is there by mistake? The request runs correcltly, it's just missing parts of the conversation model. Thanks!

Is it possible to update conversation ratings through the API? If not, is it on the roadmap?

Hi! I'm able to start tours using its corresponding URL: Ex: https://mydomain.com/page?product_tour_id=*** and using a JavaScript call too: Intercom('startTour', ***); Nevertheless, if the tour is part of a series, it seems that it doesn't work. In the JS Console I see a network call to: POST https://api-iam.intercom.io/messenger/web/tours/***/fetch but the response is 404 - Not Found. Is it possible to start out a tour programmatically if the tour is defined inside a series? Thanks!

I need help resetting my client secret, I didn't see (or find) a way to do it from the app console, I'm guessing a support rep needs to help. Thanks!

How do you derive the active now status for a user? This is shown via a "green dot" next to their icon in the contacts list. I would like this info when using the API.

Hi,I am trying to use an event from my app to update user or company data on their profile.For example I want to fire the event "add apple" and this would update the "apple count" on the user or company profile.I know how to send an event using Intercom('trackEvent', 'event name'); and I know how that I can update user data using Intercom('update', userdata); but I would like to use the event itself to update the data.Is this somehow possible ?

Does anyone know of a document that details how the tables join together. What I thought would be straight forward seems a little strange as you end up with lots of many to many relationships.