API & Webhooks

In my current integration, I made an assumption that if a contact was created and associated to a company that contact's company details would come in on the `contact.created` webhook notification. However, I'm no longer convinced that this is ever the case as I see the creation of a contact and attaching it to a company are always done in 2 separate requests in the UI or via API. Is there ever a case where the `contact.created` notification would contain the contact's company details? I haven't been able to make it work even making the attach to company API request in quick succession after creating a contact.  Are there other webhook notifications we could use to know when the contact becomes attached to a company or any other alternative approaches we could use besides polling the contact for updates?

can I have an example !

I use @intercom/intercom-react-native. User is registered with Intercom.registerUnidentifiedUser() and I use Intercom.updateUser({ Tag: 'someTag' })but when I check user in Intercom I see Tag has not been set.

I'm trying to send a new message using "https://developers.intercom.com/intercom-api-reference/reference/admin-initiated-conversation" api and i'm sending `create_conversation_without_contact_reply` key as true in the payload but the response received doesn't contain any conversation_id in it as described in api_documentation. What i trying to do is to get the conversation_id and then instead of sending a new message every time, Send a message as reply to this conversation.Am i missing something here? Or is there any work around available to handle my scenario?

Usecase: We have a requirement to create an canvas app and serve it through an API. I could create an app and also serve it through conversation message from Agent view but I am not quite sure how to send it through API. When I intercept intercom UI (Through network monitor) and how it sends app in conversation it does three things Configures the card Initializes the cardSends the card in conversation {"app_id":"----","conversation_id":"15","blocks":[{"type":"messengerCard","canvas":{"id":"-----" Is there any way to do the same thing using API?

Hi,For create_message and create_conversation have same error. create_message_url = "https://api.intercom.io/messagesquot;create_conversation_url = "https://api.intercom.io/conversationsquot; create_message:{"type":"error.list","request_id":"0000gs3ckh0kbkfn1i4g","errors":[{"code":"server_error","message":"Server Error"}]} create_conversation:{"type":"error.list","request_id":"00b89n0esi3jhj96s2og","errors":[{"code":"server_error","message":"Server Error"}]} Thanks for helping.

Hello, We are using messages API "https://api.intercom.io/messagesquot; to send emails to intercom users from our website.We are trying to send email with HTML but look like API don't support for HTML version. So We have created custom templates into intercom system.  Right now we are looking for to send emails with custom templates, please let us know how we can send emails with template from API. Thanks

I saw another question here, and the answer was referring to tags, but I would like to update the title field of the conversation via API, the update endpoint doesn't seem to work for that.

Since we migrated directly to intercom, there is no phone number attribute, there is a Whatsapp Number attribute on the intercom website but when we use the contact or conversation apis, we are unable to get the Whatsapp Number. How can we get the Whatsapp Number using contact ID ?

Hello!I am trying to create a conversation from a visitor per the doc: https://developers.intercom.com/intercom-api-reference/reference/create-a-conversation I've tried setting `type` to `contact` as indicated. When passing a `user_id` like so: { "from": { "type": "contact", "user_id": "1234567" }, "body": "Hey"} I received the error `Lead Not Found` and the conversation / contact with role lead are not created as expected. How can I create conversations from visitors? Additionally, in an ideal world I would be able to pass a singular user ID (not knowing if this is a visitor or existing Intercom user) and then create a conversation attached to the provided user if they exist, or instead a new user if they did not. Is this at all feasible? Thanks for any help.

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?