Developer Q&A

Ask technical questions about the Front Platform

  • 190 Topics
  • 325 Replies

190 Topics

T
TomtHelper
asked in Developer Q&A

Contacts list API q parameter

I am attempting to query the contacts list api and including a parameter to only get contacts updated in the last 3 days.   I understand how to construct the UNIX time stamp (I think.)My question is when I do the curl command below and update a single contact in our testing instance of Front I get back all contacts no matter the updated_at date.  Am I misunderstanding how the q works and should I only get a list of the ones that have been updated?curl --request GET \ --url 'https://api2.frontapp.com/contacts?q=\[update_after\]=1679933002.000' \ --header 'accept: application/json' \ --header 'authorization: Bearer <token>'Result for contact when it has not been updated"updated_at": 1679932512.707,Result for contact after I update it"updated_at": 1679933920.514,In both cases I am still getting a list of all contacts.

4
T
8 months ago
M
meetings-bio-devRookie
asked in Developer Q&A

Get ID of existing draft

I’m developing a plugin with SDK, where I call external API to generate me a draft body and create or update a draft.If there is no existing draft, I can call context.createDraft to crate draft. This method doesn’t seem to work if a draft already exists. I see from documentation there’s updateDraft method, which requires draft ID.How can I get such ID, if the draft already exists in a conversation?

1
S
8 months ago
V
vp-hrConversationalist
asked in Developer Q&A

Create a new internal discussion draft?

From reading the documentation, it seems clear that the Context API can create new email drafts thought context.createDraft, I can get this to work in a very neat way. However, is this all that the Context API can do when it comes to creating new drafts?I see no info on creating a new internal discussion (https://explain.helloretail.com/xQuRABAe) or comment in a thread via the Context API. Which seems like something that should fit inside the scope of the current context? Instead I have found that the Core API does have the endpoint for creating comments and drafts (emails). However, I still can’t find any info of creating a new internal discussion draft? It also seems like a little bit of a workaround to use the Context API to create a new email draft, Core API to create a new comment. Did I get this right or have I missed something here?  TL;DR question(s): 1. Is it possible to create a new internal discussion drafts via any of the APIs? 2. Can the context API only create new email d

2
V
8 months ago
B
ban.nguyConversationalist
asked in Developer Q&A

Is there a way to get message(s) currently selected by the user using the context API?

Hi, I’m currently working on a plugin that converts email messages to PDFs. To be able to do so, I need to know which messages are currently being selected by the user. However, there does not seem to be a way to list currently selected messages in Front’s context API, and to my knowledge we can only retrieve ALL of the messages inside a selected conversation using listMessages. I would really appreciate if someone could give me pointers on this. Thank you 😄.

4
B
8 months ago
B
brodielockett
asked in Developer Q&A

Where can I find detailed documentation for Front's SCIM server?

Hello, I’m setting up provisioning in JumpCloud, and I must enter SCIM details for Front manually.  I’ve made an auto-provisioning token, but I still cannot connect to the SCIM server.  My gut feeling is that the SCIM server has a different base URL than https://api2.frontapp.com, but I’m not sure because I can’t find any documentation. Thanks in advance for any help,Brodie 

2
B
9 months ago
J
JérémieConversationalist
asked in Developer Q&A

Front & Mulesoft - Connections

Hello,I need to know if I can connect Front to the Mulesoft application.The goal is to automatically send 100% of the documents received in Front, regardless of the channel, to Mulesoft, so that we can then read them and connect them to our Home Made CRM (possible from Mulesoft)Outlook can receive the mails, and send them to Mulesoft, but:I don't use Outlook of course Front receives a lot of What's App too, that's why the sending has to be done between Front and Mulesoft directlyThanks for your help! Jérémie

2
J
9 months ago
I
ianmiddelkampConversationalist
asked in Developer Q&A

How to Add / Update Front contacts using plugin sdk

Hello all!I am finding that the plugin sdk does not allow for CRUD operations on front contacts. Is this correct? If this functionality is not available I am assuming I need to work with the core API.Is there a javascript library to work with the core api?

4
Javier - Developer Relations
9 months ago
I
ianmiddelkampConversationalist
asked in Developer Q&A

is_spammer field not returned from get contact api call

I am noticing that the is_spammer field is not returned from calls to GET contacts/{contact_id}.I am trying to add the ability to mark as spammer the contact from a plugin.Im using a php backend and the response body does not include the is_spammer field.Is there something I am doing wrong?

1
S
9 months ago
V
vp-hrConversationalist
asked in Developer Q&A

Plugin SDK - list messages

I’m working on a plugin which needs to list and parse messages and discussions using context.listMessages() and context.listComments()I ever receive the whole conversation, only the first 20 discussion messages and in the case of emails 3, even though the conversations contains many more.If I understand the docs correctly, I should use the nextPageToken form the response, in order to read more/all messages. I did this according to the documentation (see code below) This however, makes no difference and I still receive 3 or fewer emails.   const listAllEmails = async () => { const emailList = await context.listMessages(); let nextPageToken = emailList.token; const emails = emailList.results; while (nextPageToken) { const { results, token } = await context.listMessages(nextPageToken); nextPageToken = token; emails.push(...results); } return emails; };https://dev.frontapp.com/reference/plugin-sdk-pagination-token I found that my nextPageToken is always

3
V
9 months ago
R
rwood12Rookie
asked in Developer Q&A

Expanded Hubspot functionality. Create a deal with more options

Hello,I am new to development and was wondering if anyone has made a SDK to connects Front to Hubspot?Ideally, we would want to make a plug in that would give us more options when creating a deal in Hubspot from the sidebar of Front.Any assistance on how to get started? Our first thought was Retool

1
Javier - Developer Relations
9 months ago
A
alexcurrimjeeRookie
asked in Developer Q&A

context.downloadAttachment( ) returning broken file object

Hi,I’m building a plugin to save a message’s attachment and send it directly to a Google Drive. The problem I’m facing is that the context.downloadAttachment() function is returning a broken file: // attachments state contains message_id and attachment_id of all the conversation's attachments const handleAttachmentDownload = (index) => { context.downloadAttachment( attachments[index].messageData.id, attachments[index].attachmentData.id ) .then((resp) => { console.log(resp) setPreview(URL.createObjectURL(resp)) }); };The promise is successfully returning a File but as we try to handle the file (previewing or sending it to a google drive it for example) the resulting uploaded file is broken. Am I doing something wrong here? I’ve tested the exact same flow with a simple file input uploader and it works fine. Thanks

1
S
9 months ago
E
ElanaConversationalist
asked in Developer Q&A

Linear < - > Front integration - link Front ticket to Linear issue via API

Might be a big of a long shot, but I was wondering if it’s possible / what it would take to mimic the behavior of the Linear.app integration of linking a Front ticket to a Linear issue. I examined the requests that are sent when linking an issue from Front, and it seems there are a fair few things that are required to make that happen. Is there any way to trigger that programmatically? Or can anyone help with the steps required to replicate that behavior? Thanks for any help!

3
J
10 months ago
K
kirkatdivvyRookie
asked in Developer Q&A

Getting Recent Conversations & Conversation Messages

I’m attempting to get conversations for the last day and see that the “List Conversations” returns conversations sorted by most recent first. But there’s no great way of validating recency. I’ve resorted to pulling all messages for each conversation and checking to see that at least 1 message was created within the last day.Seeing as the List Conversations endpoint is doing some sort of server-side sorting with an updated_at property, is it possible to expose that so I can key off of it at as well? This would also be helpful when searching conversations too.Or if there’s some other way of getting this information please let me know. Thanks in advance!

3
S
10 months ago
B
brodielockett
asked in Developer Q&A

Removing private channels with Front's API

Hello; In an effort to not miss clients contacting salespeople who have departed our company, I am modifying my offboarding script to add the user’s email to an ‘inactive’ inbox that only managers have access to.  I can successfully convert the Google user into a group and add it to the inbox, but if the user had their email set up in Front I get a “duplicate channel” error and have to go into the UI to manually delete the user and their private inbox.  Is there a way to manage this offboarding flow outside of the the UI? 

1
J
10 months ago
M
moshoodsikiruConversationalist
asked in Developer Q&A

How to query conversation by type on the api

Is there a way to fetch/list only intercom conversations using the conversation api ?

2
M
10 months ago
J
jackFronteer
asked in Developer Q&A

Programatically connect email channels to Front

As an admin, can I connect O365 email channels (private inboxes, shared inboxes, and distro lists alike) to Front programmatically through the API without touching the Front UI at all?Use case: a customer is migrating from Gmail to Outlook and making a domain change to all their email addresses, and they’re looking for the best way to reconnect all these channels to Front. If it’s not possible to do this programmatically, will they have to re-connect each channel by hand?

1
J
10 months ago
T
tomaszEnthusiast
asked in Developer Q&A

Refreshing the access token

Hello,I would like to know if when refreshing an access token (point 4. here : https://dev.frontapp.com/docs/oauth), the previous token is disabled even if his 1 hour lifetime is still ongoing, so there is only one token that is being replaced each time we do a refresh call to your API?Or the previous token is still valid till the end of his 1 hour lifetime ?Thank you in advance for your answer.

1
J
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Ratio of Messages one Sends Through Shared or Individual Inboxes

We would like to start measuring our shared inbox usage compliance, and we want to get insights from an analytics standpoint (volume for instance). We want to look into the ratio of messages one sends (either through Shared Inboxes or Individual Inboxes).

1
S
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

API Help with analytics and exporting private inbox data

I am working on using the Front API to get some data we need into our BI Tool to analyze it, but I have a few questions. Basically, I need to get from the API the same data I get if I go to Analytics and get a Message Export. I wasn’t quite able to exactly that in the API so I just need a little direction on where to find it.We will also need the export to contain messages from personal inboxes. 

1
S
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Issue with List Events API

We are currently in the process of building an integration with Front. For our use case, we found the `List Events` API here, to be suitable. We want to only list archive events in a certain time window, and for that, we have tried using the `q` parameter, as mentioned in the document, but it doesn't seem to work, the response always contains all the events, irrespective of the query we use. Attaching a few curls we have tried curl --request GET      --url 'https://api2.frontapp.com/events?q=types%3Aarchive'      --header 'Accept: application/json'      --header 'Authorization: Bearer TOKEN'curl --request GET      --url 'https://api2.frontapp.com/events?q=after%3A1651470943.000'      --header 'Accept: application/json'      --header 'Authorization: Bearer TOKEN' Combining the before and after parameters would also be helpful.Looking forward to your help on this.

2
Front Developer
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Plugin Reply-To Email Address

We utilize our own plugin integration to pull customer data on each inbound data for our sales reps to see.We capture the customer's email address using "emailaddress = context.conversation.recipient.handle;"This is working fine except for our contact forms on our sites. These all send and are properly signed from noreply@domain.com. So we are unable to lookup the customer email in our system... The customer email is set in the reply-to field of the email. Our plugin works as expected as soon as the sales rep hits reply - the front conversation recipient changes at that point to the 'reply-to' address.How can we pull the reply-to address in our plugin from the initial load before hitting the reply button??

1
S
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Raw CSAT data from API

We could not find raw data about the CSAT but only percentages. We need to recover the data of our customers in a raw format… We are used to working in that way with other CRM solutions.We need the same with front. Do you have some guideline or examples as how to recover CSAT raw data?

1
S
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Body Did Not Satisfy Requirements - Zapier

Hi, I am trying to use Front's api to send a reply to a conversation, but am receiving the error "body did not satisfy requirements" I am using webhooks via Zapier to POST to the API. I've included the text below of the inputs- I tried to match everything as closely as possible to Front's documentation. Could you provide any advice into troubleshooting this error? URLhttps://api2.frontapp.com/conversations/cnv_12345/messagesPayload TypejsonDatato"person@example.com"options{"archive": true}signature_id"sig_12345"sender_name"Dale"channel_id"cha_12345"body"test"subject"test message"Wrap Request In ArrayfalseFileUnflattentrueBasic AuthHeadersAcceptapplication/jsonAuthorizationBearer xxxxxxxxxContent-Typeapplication/json 

1
S
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Front Events API "after" filtering issue

We've been running into an issue implementing the event sync from Front. While the webhook is working correctly, the alternative sync we wrote using the Events API seems not to respect the after filter in queries. When we make a request to e.g. https://companyDomain.api.frontapp.com/events?q=after:1652647350.45151, rather than getting only very recent events (that was basically the current UTC timestamp when I made the request) we get a paginated response with hundreds of thousands of results. Is this a bug on the Front end, or is there a different syntax we should use to query events after a certain time?

1
S
10 months ago
Front Developer
Front DeveloperFronteer
asked in Developer Q&A

Sending Calendar Invites Thru API

We’re hoping to send calendar invites through Front messages. Historically we’ve included the calendar invite as inline to the message using the multipart/alternative property where the invite renders as part of the message, but not sure this is available through the Front API.

1
S
10 months ago

Badge winners

  • Front Certified Admin
    trowehas earned the badge Front Certified Admin
  • Front Certified Admin
    adrianhas earned the badge Front Certified Admin
  • Icebreaker
    MaggieLhas earned the badge Icebreaker
  • Beta Tester
    madmhas earned the badge Beta Tester
  • Beta Tester
    amacehas earned the badge Beta Tester
Show all badges
Terms & ConditionsCookie settings