API & Webhooks

In the API doc: https://developers.intercom.com/intercom-api-reference/reference/conversation-model/p> admin_assignee_id is mentioned as type string, but on api calling it is coming as integer. 

Hi, I am getting a "user not found" reply from the API however the user ID is correct AND existing.I am wondering what could be wrong as I am using the access token that is referenced in our account... any help

When attaching a tag to a conversation, they do not always appear in the conversation view. They do, however, appear against the conversation when retrieved via the API. What can I do to mitigate this and ensure the tag always shows in the conversation? My workflow (simplified), using the node intercom client, is: - await conversation creation- await attachment of one or more tags Intercom client always responds successfully, however, it appears there is some internal intercom mechanism to associate a tag with a conversation part, and that perhaps there is a race condition between the part becoming available and the tag being attached. When I retrieve the conversation from the API, i can see that the tags are attached to the conversation.

Is there a list anywhere of what token errors mean? We're getting this reply for one of our customers:{"type":"error.list","request_id":"002qgl7rvpn5e8fi3vf0","errors":[{"code":"token_suspended","message":"Unauthorized token, suspended application"}]}And we're not sure if 'suspended application' refers to us, or the customer's account.

Hello, Using v2.4 of the API. We have a webhook on 'conversation.admin.closed', that return a conversation-ish object. Some fields from the documentation are not there (like 'contacts' or 'source') and we have extra fields (like an 'assignee' object). This documentation seems to says that it's a "Conversation data", but what we get do not match the conversation model. Is this realy a conversation model or something else ? Where can I find the documentation for this ? Example of data we get : "data": { "type": "notification_event_data", "item": { "type": "conversation", "id": "xxxxxxxxx", "created_at": 1651678878, "updated_at": 1651678890, "user": { "type": "user", "id": "xxxxxx", "user_id": "xxxxxxx", &qu

I installed the messenger to our site via GTM per these instructions. It works as expected however our Engineer noticed the script is having a negative impact on our page load times.  The article recommends using "Window Loaded" as the trigger, but I'm wondering if anyone knows of any different triggers that could be used to delay the script from loading until after the main elements on the page. I see GTM has options for Timer based or Scroll triggers and thought these looked promising.  Anyone have any input or recommendations here? Thanks

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":"0003pv47mhfa21qk9k60", "errors":[ { "code":"invalid_field", "message":"tags_id is not a valid search field" }] }Is the documentation

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-modeland then use the author from the source object. Is that correct? Thanks in advance.  

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