Skip to main content

Developers

Community topics about Front APIs and SDKs

459 Topics
steve
steveRookie
asked in Developer Q&A
404 for newly imported message?

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?

2313
justin
jim
jimConversationalist
asked in Developer Q&A
Sidebar Plugin: Need 'allow-modals' for window.confirm() to work

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?

1233
jason
Javier - Developer Relations
Javier - Developer RelationsCommunity Manager
published in API news & updates
[us-west-2] Downtime / maintenance affecting conversations API endpointsIMPORTANT

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

350
Javier - Developer Relations
JamesSpratt
JamesSprattRookie
asked in Developer Q&A
API Analytics Measures

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?

2121
justin
kenneth_stoecklin
kenneth_stoecklinRookie
asked in Developer Q&A
Create valid custom SMTP channel?

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.

911
jason
wesam
wesamConversationalist
asked in Developer Q&A
Add custom message to a conversation

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

2483
jason
timk
timkRookie
asked in Developer Q&A
Can you create a keyboard shortcut for the Block Sender button?

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. 

311
Maxime Haudebert
lindsay_rawitscher
lindsay_rawitscherConversationalist
asked in Developer Q&A
How to build reliable sidebar applications

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? 

1351
jason
benwa
benwaEnthusiast
asked in Developer Q&A
Same page_token in search endpoint

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

571
jason
wesam
wesamConversationalist
asked in Developer Q&A
Merge conversations or move messages to different conversation via API

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

1341
jason
SamH
SamHEnthusiast
asked in Developer Q&A
Voice Messages

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

921
Maxime Haudebert
Javier - Developer Relations
Javier - Developer RelationsCommunity Manager
published in API news & updates
Logistics TMS sample plugin availableNEW SAMPLE CODE

 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

2110
Javier - Developer Relations
S
szymonRookie
asked in Developer Q&A
Forbidden

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?

2081
jason
natalie
natalieConversationalist
asked in Developer Q&A
Partnering with Front when your Integration is neither a Channel nor a Plugin

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.

1812
natalie
Tamirb
TamirbRookie
asked in Developer Q&A
Monitoring reopened conversations

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? 

3151
jason
katie
katieConversationalist
asked in Developer Q&A
How to find existing report_uid for Fetch an analytics report endpoint

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!

662
katie
silvana
silvanaConversationalist
asked in Developer Q&A
WHATSAPP CONVERSATION

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

2194
justin
scott_ecosystem
scott_ecosystemRookie
asked in Developer Q&A
Find the id of the user who granted OAuth2 access

I’m currently trying to understand whether there’s a way to determine which user granted the OAuth token I’m using in the request?I’ve found the `API Token Details`, but that appears to only expose company-level information.Could I achieve this by introspecting the JWT claims? (e.g. `sub`?) 

731
jason
peter_at_prello
peter_at_prelloConversationalist
asked in Developer Q&A
FrontChat Widget init with "CustomFields"

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

1032
jason
peter_at_prello
peter_at_prelloConversationalist
asked in Developer Q&A
Chat widget SDK Documentation

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

2832
peter_at_prello
kap
kapFronteer
published in API news & updates
New closeDraft method availablePlugin SDK

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.

1250
kap
Tom Yuan
Tom YuanConversationalist
asked in Developer Q&A
How to generate a conversation link from a `/channels/xxx/incoming_messages` response

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!

1994
jason
natalie
natalieConversationalist
asked in Developer Q&A
Application Webhooks for Published Application

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?

1131
justin
hily
hilyRookie
asked in Developer Q&A
Unable to authenticate - Application Channel

I’m testing out the postman libraries shared from front.When testing out the Sync Inbound message endpoint, no matter what I do/chnage I get the below error. Anyone else seen this? {"_error": {"status": 401,"title": "Unauthenticated","type": "resource_unavailable","message": "Invalid token"}}

1272
Javier - Developer Relations
eduardo_pereira
eduardo_pereiraConversationalist
asked in Developer Q&A
Front WebChat connection error

Hi community!So I’ve been going through a POC using the Front webchat and everything worked until I try to identify the user.Once I run the FrontChat(‘identity’, {...}) script, when I try to send a message through the chat I get “Not delivered - connection issues.”If I never identify the user, it works like a charm. (Other scenario) If I run the init with the identity fields I get 400s.Can some help?

2802
eduardo_pereira

Badge winners

Show all badges
Terms & ConditionsCookie settings