A message is a resource which can be either received or sent via an inbox. Messages are grouped by conversations.
A message can be either inbound (received) or outbound (sent). You can know if a message has been received or sent thanks to the boolean is_inbound.
Each message has a type depending on the channel it has been sent with:
Type | Description |
|---|---|
| Email message |
| Message from Twitter |
| Direct Message from Twitter |
| SMS message |
| WhatsApp message |
| Message from Smooch |
| Message from Facebook |
| Message from Intercom |
| Phone call |
| Custom Message |
Twitter Notice
In order to comply with Twitter's API Terms & Conditions, Twitter content is not distributed through Front API.
The fieldsblurb,body,textas well as recipients'handleare replaced by the string[REDACTED]for messages of typetweetortweet_dmonly.For those messages, the payload includes the field
metadata.external_idcontaining the ID of the original Tweet or Twitter Direct Message that can be used to fetch its content from the Twitter API directly.
Opening a message in Front
To open a message in Front you need to open the URL https://app.frontapp.com/open/{message_id}.
Example Message Object
{
"_links": {
"self": "https://api2.frontapp.com/messages/msg_55c8c149",
"related": {
"conversation": "https://api2.frontapp.com/conversations/cnv_55c8c149",
"message_replied_to": "https://api2.frontapp.com/messages/msg_1ab23cd4"
}
},
"id": "msg_55c8c149",
"type": "email",
"is_inbound": true,
"draft_mode": null,
"created_at": 1453770984.123,
"blurb": "Anything less than immortality is a...",
"author": {
"_links": {
"self": "https://api2.frontapp.com/teammates/tea_55c8c149",
"related": {
"inboxes": "https://api2.frontapp.com/teammates/tea_55c8c149/inboxes",
"conversations": "https://api2.frontapp.com/teammates/tea_55c8c149/conversations"
}
},
"id": "tea_55c8c149",
"email": "[email protected]",
"username": "leela",
"first_name": "Leela",
"last_name": "Turanga",
"is_admin": true,
"is_available": true,
"is_blocked": false
},
"recipients": [
{
"_links": {
"related": {
"contact": "https://api2.frontapp.com/contacts/crd_55c8c149"
}
},
"handle": "[email protected]",
"role": "to"
}
],
"body": "Anything less than immortality is a complete waste of time.",
"text": "Anything less than immortality is a complete waste of time.",
"attachments": [
{
"filename": "attachment.jpg",
"url": "https://api2.frontapp.com/download/fil_55c8c149",
"content_type": "image/jpeg",
"size": 10000,
"metadata": {
"is_inline": true,
"cid": "123456789"
}
}
],
"metadata": {}
}