API & Webhooks

We are wanting to build a custom section that contains a series of categories that can be opened and closed to see the underlining content. The content could be a listing of videos or gifs like in the example below or a series of links. Interested to understand if this is possible in Intercom and if so, we may also be interested to hire someone to help implement this for us. Looking forward to the replies.   

I've been trying to create an onboarding flow for new users on my app. I use the intercom API to create a new contact, but how do I make every new contact added get a welcome email? How do I trigger that email?

I have a custom form on a website, and I want to use the form to send an email, or message, to Intercom. I don't want to use the chat widget.

As per the API documentation v2.4, the endpoint `Detach a tag from a conversation` doesn't need any parameter. But on making a call, it throws an error `admin_id` is required.Seems like discrepancy in the documentation.Please correct it ASAP, as it is impacting us highly.

I have deleted a company with the company_id of "1", that company is no longer visible anywhere in the Intercom interface. However I can see it in the API (using your official Ruby gem) with a call to:client.companies.find(company_id: "1")So the delete command must be just soft deleting companies. When it comes to contacts you can hard delete them from the account settings page (settings/delete-user), is there any such call for companies? I noticed this during development when reseting my database and attempting to create a new company. I have logic that attempts to find or create a new company for a given ID, in this case it appeared to work successfully because it was updating data on the soft deleted company.

I got registered on the intercom from my mobile and I was using the messenger, after reinstalling the app I am getting this errorFailed to register or update user: {"type":"error.list","request_id":"000r73k9800sstpeesi0","errors":[{"code":"conflict","message":"Multiple existing users match this email address myemail@gmail.com - must be more specific using user_id"}]}How can I check whether my email is registered or not on intercom

Is there any way to rate a conversation after agent closed the conversation through Intercom API? Instead of using Intercom task bots asking for conversation rating on?

Hi!  I'm looking at loading a user's conversations and trying to find out if a specific tag is attached to a conversation. I'm using https://developers.intercom.com/intercom-api-reference/reference/search-for-conversationswith v2.4  current query on /conversations/search{ "query": { "operator": "AND", "value": [ { "field": "contact_ids", "operator": "=", "value": "myUserID" }, { "field": "tags_id", "operator": "=", "value": "myTagID" } ] } }response:{ "type":"error.list", "request_id":"0003pv4

Our platform sends event data to intercom each time one of our members makes a room booking. Each time a booking is created in our app, we send the event to intercom and include things like start_date in the metadata.  As per the API docs, the date is sent as a UNIX timestamp and appears to be correctly recognised however, it doesnt give us date appropriate options for outbound rules. The First_Seen filter allows us to select 'before' or 'after' the date whereas our own event data only permits 'grater than' 'less than' type options (see screenshots).  Is this just a limitation of intercom or is there a differetn way we can format event metadata to unlock the full power of outbound rules?

As per the api doc: https://developers.intercom.com/intercom-api-reference/reference/create-a-conversationWhen creating conversation, We should send the type as lead in from object. But on doing so, I get the error, user not found.{ "type": "error.list", "request_id": "00034vg9jrnkg43k9mf0", "errors": [ { "code": "not_found", "message": "User Not Found" } ] }  But when I change type to `user`, it worked. Expected:For lead, we should pass type as `lead` only not `user`.

We've been operational for 1 month but have only just implemented Intercom. We would like to backfill intercom with events that have occurred over the past month so that we can create useful segments e.g. if someone registered for a webinar last week can we push that to intercom as an event with metadata? Many thanks!

Is the API really up and running? I keep getting responses saying the API service is temporarily unavailable. I have yet to receive a working response in the past two days. When attempting to exchange an auth code for a token at https://api.intercom.io/auth/eagle/token we receive this error: {  "type": "error.list",  "errors": [    {      "code": "service_unavailable",      "message": "Sorry, the API service is temporarily unavailable"    }  ]} We are also unable to authenticate with our own token from our developer hub. Is anyone else having these issues? We have an approved app that used to work and now we are stuck with a broken user experience.

I have been experiencing very slow API response times recently. Upwards of 10+ seconds and some never returning for both the list tags and search conversations endpoints. I checked the rate limit and seems to be plenty left, besides I do end up with a 200 response when it does eventually return. Not really sure whats going on so any guidance would be appreciated.

Is there a way to delete articles at once?I heard that you can delete the articles in bulk through api at once.Is there a team that has done that?

Regarding this endpoint - https://developers.intercom.com/intercom-api-reference/reference/reply-to-a-conversationIs there a limit to the size for body? If there is, what is that limit? We want to be able to send a transcript of previous conversations to the agent but we were wondering if there is limit to the length of the body that we can send in the payload in a single call.

Hi. I am using the unstable version of the API to export all messages sent in a given timeframe.Reference: https://developers.intercom.com/intercom-api-reference/v0/reference/downloading-the-data I wonder why Sender is not included in the exported data?How to retrieve that information? My best guess is that I have to use the ConversationID returned from the exported message data to retrieve information on the conversation as per:https://developers.intercom.com/intercom-api-reference/v0/reference/conversation-

Despite there is a dedicated property in data attribute object model, called 'label' which is supposed to provide a value for the custom attribute to be displayed in UI, looks it does not work. Even after I send a request to create a new property with some name in 'label' field, a property will be shown just as specified in 'name' attribute, with first letter capitalized. For example, if name=myCustomProp and label=My Custom Prop, then in UI it comes as 'Mycustomprop'. This is just not quite user friendly... https://www.intercom.com/help/en/articles/320-tracking-user-data-in-intercom

Here is my request body:{ "email": "test@gmail.com", "role": "lead", "name": "First_name Second_name", "created_at": "123123123", "custom_attributes": { "Plan": "Plus", "Facebook": "https://facebook.comquot; } } 

Have webhooks been updated to the subscription types feature? I need to synchronize my app with subscription preferences expressed by the users. I'm currently using user.unsubscribed webhook to keep track of cancelling subscriptions from emails link, but now I've been asked by the product team to update our outbound to different subscription types, therefore I need a more specific notification. Is this webhook already implemented? Thanks

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 a

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?