Developers

This morning a bunch of users started having messages fail with “Send Later: This message will be sent in 1 minute” then “Failed to send. Message temporarily rejected by mail server.” Frontstatus implies everything’s OK; downdetector tells me GMail’s OK. I don’t know what the issue is or what to do about it.Do you?Regards,Brian

I was recently asked how to automatically transition a Front Chat conversation into an email thread. While there’s not currently a way to do this natively in Front, using a rule and basic Zap allows you to build a quick automation to turn a chat conversation into an email thread. There’s plenty that could be improved about this approach, but I hope it serves as a good template for building an automation like this.  The JS code from the Zapier Code step shown in the screencast is:try {  // Fetch the contact info  const res = await fetch(inputData.contactUrl, {    headers: { Authorization: 'Bearer YOUR_API_TOKEN' }  });  const contact = await res.json();  const emailHandle = contact.handles.find((h) => h.source === 'email').handle  if (!emailHandle) {    return {error: {message: "No email handle found"}}  }    return {email: emailHandle}} catch (error) {  return { error };} 

Custom Fields in the Core APIThe Core API now exposes endpoints to list the custom fields that can be used on different resources:Use GET /accounts/custom_fields to list the custom fields available on an Account (docs). Use GET /contacts/custom_fields to list the custom fields available on a Contact (docs).Use GET /conversations/custom_fields to list the custom fields available on a Conversation (docs). Use GET /inboxes/custom_fields  to list the custom fields available on an Inbox (docs). Use GET /teammates/custom_fields  to list the custom fields available on a Teammate (docs). In addition, the Custom Field data model now returns all the supported values for the Custom Field of type enum. Accessing email messages in the .eml formatThe Get message (GET /messages/:message_id) endpoint now supports customizing the response's Content Type.By default, the endpoint returns the documented JSON data. However, you can now request the response to contain the message in the .eml format by setti

I’m successfully creating new conversations by posting `/inboxes/inb_1234/imported_messages` endpont.  it returns something like:{ conversation_reference: '...', message_uid: 'abcdefg88fbc88046053ecd6e319', status: 'accepted' } I want the conversation id from that so I can add links etc.   So I’m passing the message_uid to messages as so:curl --request GET \ --url https://api2.frontapp.com/messages/alt:uid:abcdefg88fbc88046053ecd6e319 \ --header 'accept: application/json' \ --header 'authorization: Bearer <token>but that returns: { "_error": { "status": 404, "title": "Not found" }} What am I doing wrong?

My sidebar plugin has some interactions that invoke confirmations via `window.confirm()`, e.g. deleting a line item pops up “Are you sure?” type messages.These currently don’t work when viewing app in Front’s iframe sidebar, and I believe it’s because the “allow-modals” permission is not set on the iFrame sandbox.Can this be added?

Between Sunday 2023-10-22 0700 UTC and Sunday 2023-10-22 0800 UTC, customers in our us-west-2 data center region may experience an interruption to loading conversations, loading conversation lists, and reopening conversations from an integration. This is due to planned maintenance work required on a core database service. What is the impact?During the window, the conversations viewing experience will be degraded or unavailable. The display of new messages, counter updates of all workspaces, and some asynchronous conversation mass-actions will be delayed. Developers trying to use the API via integrations may receive a 503 "service unavailable" error in their list conversations responses during the interruption. This should be resolved once the maintenance is complete. Why are we doing this?One of our core database clusters needs to be restarted during the maintenance window while we perform an important security upgrade. We are doing this type of work during off-hours to minimize disrup

I have been dabbling with Front’s Analytics via the API. One thing I cannot seem to find is what interval is being used for the time based metrics. My assumption is that these are seconds and that each of them is in the same interval but that is not specified in any of the documentation. Could someone help clear this up for me?

Hello everyone!I am trying to execute the process of custom SMTP channels creation, using the API. I am having trouble trying to setup a custom smtp channel that is validated and is properly configured (smtp server, port,...).With api2.frontapp.com/inboxes/XXXX/channels I manage to create an smtp channel, but it’s not valid, and the SMTP settings I send in the JSON body are not set up (although they are taken by the request).With api2.frontapp.com/channels/XXXX/validate I am able to validate that newly created channel according to the response, but in Front’s UI I am still required to send the validation test email.Trying to use PATCH api2.frontapp.com/channels/XXXX is not valid, since I cannot setup the custom SMTP settings for the channel that way (only a handful of settings that I don’t need).Am I doing something wrong here, or is the process I’m trying to do not possible to execute via the API?Thank you very much.

I am using the custom channels API to add receive custom messageshttps://dev.frontapp.com/reference/post_channels-channel-id-incoming-messages How do I add the new custom message to an existing conversation? The metadata.thread_ref seems to be independent from the conversation ids.E.g. I added a custom message and pass“metadata”: { “thread_ref”: “cnv_#####” }doesn’t add the new message to that conversation and instead creates a new conversation. New messages using the same thread_ref goes under the new created conversation. Thanks

Can we create a shortcut for this to reduce the 2 clicks?This is a killer feature. No email client has this at this time. 

I am having trouble finding any documentation about what can be embedded/displayed in a sidebar app. I have built simple github hosted sites but find that the front sidebar is not responsive, so I have to actually hardcode the screen dimensions.  Are there any documents or parameters people have found for these custom sidebar plugins? 

Hello,I have using the search endpoint for conversations in a script for several weeks but I have a recent problem with the page_token that seems to be the same at each response.So my script is running in a loop and don’t stop anymore.Have you changed anything in your page_token generation ?Has someone have the same problem?Thank you for your help

Hi,I am building a custom channel that handles group mms and I need to either merge conversations or move messages on to a different conversations via API.For example, a user on front app composes a new message, but we already have a conversations id internally for the participants. We want that message to be added to the conversation id that we had instead of creating a new conversation. I am returning the “thread_ref” with the correct id, but it doesn’t seem to move the message to the original conversation or merge them. This is the same behavior for native SMS messages (when sending a new sms message via API, a new conversation is initially added, but than the message moves to the correct conversation). Thanks

When will there be an option to send voice messages within Front?

 We just launched a new sample plugin application on the Developer Portal that demonstrates how to use the Plugin SDK to load data from an external system of record and display it to the Front user. The plugin provides advanced interactivity, allowing the Front user to reply to conversations with contextual data or attach documents from the external system to the draft. In our example, we mock a Transportation Management System (TMS) that might be used by a logistics company to manage data about transactions or shipments. Check out a video overview  The sample plugin can be adapted to any number of use cases and industries: customer service, finance, retail, hospitality, real estate, etc. The plugin demonstrates the following concepts:Loads the Front Plugin SDK through React context Reads data from a RESTful API and displays it in the Front sidebar Implements the Front UI Kit to save time developing UI components Detects links attached to the selected Front conversation and loads recor

I’ve tried to send new message reply with signature via API:POST https://api2.frontapp.com/conversations/cnv_xyz/messages However I’ve got an error like this:{ "_error": { "status": 403, "title": "Forbidden", "message": "This agent is not allowed to read the \"signature\" with ID: \"1234567\"" }}So I tried to list signatures of my account like this:GET https://api2.frontapp.com/teammates/tea_xyz/signatures/But  I’ve got something similar{ "_error": { "status": 403, "title": "Forbidden", "message": "You do not have access to the resources of this teammate." }}What should I do in order to send message with signature?Where should I add some rights/permission?

Hi there, I have just written an integration that interfaces with the core API and I am beginning the process of trying to get it listed in the integrations marketplace. However, I am slightly confused by the Airtable form: The “Screenshots” field is required, with the directive to “include at least one screenshot of how the integration appears in Front.” The problem is that our integration does not appear in Front at all. What would you like us to show? What is meant by “Website or landing page url”? Would you like our homepage or the URL that users should go to to start the installation flow?Thanks so much.

Hi,This is the plugin we're building: https://www.zendesk.com/apps/support/470124/thank-you-gpt/We've been trying to monitor re-opened tickets in front (That were archived and then reopened by the user) however haven't been successful. What'd be the best way to do this? 

I am looking to use the Fetch an analytics report. endpoint to pull in a report that I already have created. However, I am not seeing a way via the API to list out the existing reports so I can locate the report_uid. I also do not see the report_uid in the URL of the UI or listed anywhere else.Can I only fetch analytics reports that I’ve created via the API with the Create a new analytics report. endpoint? Or is it possible to fetch existing analytics reports that were created in the UI?Thank you!

Hello, We recently started working with the Number plugin to send WHATSAPP messages. Is there any way that we can start a conversation on the WHATSAPP channel and add a customer without having to type the whole name or phone number? Typically, when creating emails, we can type the first few letters and suggestions would come up. but not for WHATSAPP conversations

Hi,I don't understand how to use the customFields with the FrontChat widget.When I try and declare them when doing a 'ChatFront init', how can I use them to apply 'Rules' on ma associated Inbox ? Thanks

Hi,would it be possible to have a more complete documentation about the "Chat Widget SDK Reference"?Typically, the 'option' object, what are all the possible parameters? Also the events listener, except the "onUnreadChange" listener, what else do we have? Thanks

Composer plugins now have access to a closeDraft function, which both closes the composer plugin and the draft composer in Front. This is useful for plugins that send messages directly within the modal window. For example, in the following screenshot, the Send Template button sends a message template through a channel, and uses the closeDraft function to close both the composer modal that contains the button AND the draft composer behind it. Note that this method is available for composer plugins but not sidebar plugins. Learn about the closeDraft function on the Developer Portal.

Hi, front team, I’m using `/channels/xxx/incoming_messages` API to create custom message to front.I got a response like```{"conversation_reference":"xxx","message_uid":"xxx","status":"accepted"}```how can I generate a link to this conversation, to help to link to the conversation directly from our internal system?Thanks!

I am currently building out an application that I am hoping to get published in the app marketplace. This app relies heavily on Webhooks, and I’m trying to figure out how an application with access to multiple front instances could differentiate between events from each instance. Is there something I’m missing in the documentation?