Developers

Community topics about Front APIs and SDKs

88 Topics

Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Differentiating between teams and team inboxes from an Event message?

How do we tell what are the Teams and Team Inboxes related to an incoming email Event message? Or for a conversation? From the examples, I guess the inboxes part would be it and the is_private boolean would be false for Team Inboxes? 

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Importing Messages into a Custom Channel with thread_refs

Hi, I'm looking to figure out how to import an outbound message created by our automation into our custom channel for viewing in Front. I currently have this api call: await axios.post(      'https://api2.frontapp.com/inboxes/inb_xxx/imported_messages',      {        body_format: 'markdown',        body: 'test',        subject: `Test Chat with ${to.first_name} (${to.type === UserType.Owner ? 'Owner' : 'Renter'})`,        sender: {          name: 'Test Operator',          handle: 'test_operator',        },        to: [          `test_user_id:${to.id}`,        ],        metadata: {          thread_ref: `support_chat_user_id:${to.id}`,          is_inbound: false,          should_skip_rules: false,        },        external_id: `test_message_id:1234`,        created_at: Date.now() / 1000,        type: 'custom',      },      {        headers: {          Accept: 'application/json',          'Content-Type': 'application/json',          Authorization: 'Bearer ' + frontappApiKey,        }     

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

SDK - openUrlInPopup

Quick question / clarification. What value are do you expect in the property "url" for "openUrlInPopup"? Could you give an example?  Thank you

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Query contacts by handle

I'd like to find a more efficient way to look up a specific contact in front when I don't have the contact id or the conversation id. Ideally I could query the contacts by the phone number but I can't find a way to do that without paginating through all the contacts. Am I missing something or is this intentional?

2
Front Developer
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

How to update a contact's phone number

Hope you’re good. Please can you advise how I can change a phone number via the API? I have been able to change all the other fields with the below JSON example but phone doesn’t seem to work. Example JSON body:{    "name": "Dale Cooper",    "phone": 5125555555,    "custom_fields" : {        "ContactID": 12345,        "AccountNumber": "P1234",        "CustomerGrade": "CC2",        "EnhancedGrade": " ",        "BranchName": "Acme Services",        "County": "Leicestershire",        "OuterPostcode": "LE"    }} Also tried this separately within the contact object: {     "handles": [        {            "source": "phone",            "handle": "5125555555"        }    ]} Thanks

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

List Events q parameter

Can you please provide some examples of working list events queries using the q parameter. I am particularly interested in making use of the types filter.  https://api2.frontapp.com/events?q=<help> All my attempts at using that parameter have either returned an error or had no effect and I was unable to find any examples in the documentation.

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Team Member ID

Our team leverages Zapier for a number of automations. One of the fields that we utilize is the Assignee field. This requires that we input a User ID (for example, the teammate ID’s in the form of tea_XXX) to assign the conversation to a team member. While I am able to find this ID within Zapier, it can be rather cumbersome to search for each user individually.Question:Where can I find the User ID for each of my teammates (or myself) within Front?Thank you in advance

3
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Detecting inboxes and identifying the owner

We are writing an app that processes message body and attachments in an inbox. As you know, an inbox can have multiple channels. When a rule files on arrival of a new message in the inbox and Front sends a notification to our webhook, we want to be able to identify which inbox this message is from and whether that inbox has a subscription with us. One way that we thought we could identify inboxes was using the Inbox Id that is in the JSON payload. To use this, we’d need the user to provide the identifier (id) of the inboxes that they want to be supported to the app. I am wondering whether the Inbox ID is accessible somewhere in the Front Admin UI we cannot find the client admin users can find them and enter them into a configuration page on the app side (we could not find them in an initial look)? If this is not the best way to identify inboxes and inbox owners, based on the message payload that Front sends, do you have any alternative suggestions?

2
Front Developer
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Problems showing the Chat JS widget

Hi, We're using the JS Chat Widget API. I found an issue when using the `show` command. If the 'show' command is run too soon after the 'init' command, it has no effect. Delaying the 'show' command by using setTimeout seems to work around the problem. Is this a bug? There doesn't appear to be a way to tell if the chat is ready to be shown or not. Thanks for your help

3
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Forwarding email via API

Hi guys,How can I forward an email using the Front API? I don't see a method for that, although the Forward button exists in UI.Any suggestions?

3
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Get Channels API filtering - Locate inbox ID for a contact

Our use case is that we want to automate the process of adding a new Twilio phone number to an existing inbox. So that the agent can continue to receive sms responses from both numbers (old plus new one). Since each inbox was created manually on the Front website, we can't locate the inbox id for a specific agent.  Want to know if the Front team can support filtering on the Get channels endpoint?

2
Front Developer
1 month ago
Javier - Developer Relations
Javier - Developer RelationsCommunity Manager
published in Developer Q&A

When to post in this forum versus contacting Support

This forum is the primary way to receive API assistance. Post questions about our APIs and SDKs in this forum. Posting questions here allows other developers to learn from your question and allows the broader developer community to suggest innovative solutions or respond with follow-up questions of their own. However, there are times when you should contact Front Support instead. These include:Reporting bugs or performance issues When you need changes made to your Front account When you need to share private information to troubleshoot a problem  If your issue does not fall into one of those categories, then please post in this forum. Rest assured our Support Engineers and community gurus will see your question and respond before you know it!

430
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Chat icon is not showing

We were showing front chat app icon on FE to communicate with our support team, everything was working fine from the past years, recently the icon is not showing anymore, We have initialised FCSP token and frontChat too. But we don't know how suddenly this stops working.Is there any expiry date in token?Or is there any change is script to integrate front chat?<script src="https://chat-assets.frontapp.com/v1/chat.bundle.js"></script><script> window.FCSP = 'xxx';</script> 

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Question about creating a conversation for existing an contact and retrieving the conversation ID

The way we are currently using Front is we create contacts beforehand using https://dev.frontapp.com/reference/post_contacts and then use https://dev.frontapp.com/reference/post_channels-channel-id-incoming-messages to create a conversation for them with one of our agents. This endpoint works for us because we can pass contact_id in the sender object but the problem is it does not return the conversation_id that we need for sending further messages within this conversation. Instead we are getting back the message_id only and have to query for the message entity to get the conversation_id from it. This makes our flow inefficient.  Another way to create conversation is https://dev.frontapp.com/reference/post_channels-channel-id-messages and it does return the conversation_id but it does not accept contact_id param to create conversation for existing contact. Ideally we want to be able to create conversation for existing contact_id and receive back the conversation_id in the same request.

1
S
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Webhook loading times

My webhook  loading time is around 5.3 sec but it works for "inbound" message events  and you recommended loading time below 5 sec so for manual move do we have different webhook loading time and what do you recommend 

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Events payloads for rules

What are the differences in events payloads for “move” events between rules and manual user actions?

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Last message user was on - Front plugin

Can we find which inbox/mailbox/folder the user is in at any given time via the Plugin SDK?This is then used so that when the user later returns to the inbox we can return them to the last message they were on in that particular mailbox.

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Front Events Download Question

We are currently after a historical backload of our Front's event stream prior to 14-06-2022.I've looked at the get_events API and tried fetching events from it but:No matter how we specify the start/end timestamp parameter the API will return the event starting from the current time It only emits 15 events per fetch.Please let me know

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

List or search for conversations with status = assigned

Using the API, I would like to list all the conversations with status = "assigned" as described here:https://dev.frontapp.com/reference/list-conversations I'm not sure how the endpoint should look like. Can you please send me the endpoint with the query params? Thanks

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Do you support OAuth? How can I get my OAuth credentials and update redirect URLs?

Looking for information on OAuth. Also, does it support PKCE?

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Do you have information about rate limiting?

I’m looking for your rate limiting policies

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Where to specify the URL where messages should be sent from Front to a custom channel?

We are wanting to use the API to create custom channels. The only piece we can't automate right now is creating the Channel. We have the inbox, but need a way to create the channel, and add it to the inbox so that we can get the channel ID, add our endpoint to the channel for messages, etc… Where in the API would be input endpoint for our service when messages are sent from Front?

1
Javier - Developer Relations
1 month ago
Javier - Developer Relations
Javier - Developer RelationsCommunity Manager
published in News & Updates

Create and manage apps directly in FrontPlatform Update

You can now create and manage apps directly in Front with the new Developers page! The Developers page is available in your company settings (you must be an admin to view).  View and manage all your apps in one placeWhether you're creating a Core API integration, a plugin, or a new channel type, the Developers page will be your one-stop shop for managing all the integrations you are developing or have published in the past. Read the full details in the Create, manage, and publish apps topic. Obtain OAuth or API token credentials without requiring assistance from Front SupportYou no longer have to contact Front Support to obtain OAuth credentials for your apps. You can now obtain your client ID, secret, and specify redirect URLs directly in Front for new apps. Note that existing OAuth credentials will continue to work, but will not appear in the app list.The new Developers page also lets you manage API tokens, which used to live under the Plugins & API section of the settings (remov

590
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Adding a comment to a conversation in a custom channel

To add a comment to a conversation, the API requires us to pass the conversation ID. But when we create the conversation using the API in the custom channel, we do not get the conversation ID in the response. The response for the above only gives us the following keys:conversation_reference message_uid statusTo pass a comment after creating the conversation, we need the conversation ID.How do we get this?Sample response data:data: {    conversation_reference: 'i:16623333570-h:62fb674ca562f438cbaeba4c06_game_62e4fc8e73e3232322668b3efbe3',    message_uid: 'fe445d0cb7b72a48460829e74fd82332fdcd',    status: 'accepted'  } 

1
Javier - Developer Relations
1 month ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

CSAT API endpoints

Are these the only API end points for CSAT data? num_csat_survey_response and pct_csat_survey_satisfaction ?  What is the suggested method for customers to get all CSAT data via the API? Would it be by leveraging a full events export?  What if they also want the "raw" CSAT data? Looks like those end points will only pull total # and averages, correct?

1
Javier - Developer Relations
1 month ago

Badge winners

Show all badges
Terms & ConditionsCookie settings