Get historical messages
With a single call, the Engage API can fetch the latest SMS and email messages saved for a specific contact.
GET /api/v3/contacts/{ContactId}/messages/latest
By default, the latest 100 messages will be fetched. By adding the parameter count to your query, you can request any number up to the maximum of 500. A query to this endpoint will look like this:
GET /api/v3/contacts/111d3329-7eef-45c0-37f9-ae9300a0dacei/messages/latest?count=350
Note
This endpoint is primary for first-line support platforms, allowing customer service employees to quickly troubleshoot a contact's sent messages without having to log into Voyado Engage.
Response codes
You'll get one of these two response codes:
'200' : OK
'404' : ContactNotFound
Response
{
"count": 2,
"items": [
{
"messageId": "c524e468-pee9-43d5-8f33-af3801140666",
"name": "test",
"sendDateTime": "2022-10-24T16:47:45+00:00",
"type": "SmsMessage",
"source": "Manual",
"isTransactional": false,
"status": "Delivered",
"messageLink": "https://myurl.customer.staging.eclub.se/Open/SmsOnline/Show/aOQaxknO1UOPRq84ARQDBB",
"messageText": "Hello and welcome to ExampleShop. Please add your consent and email here [[registrationUrl:123456c7-79bb-41d4-8db8-af2a00894f33]]"
},
{
"messageId": "d4afac12-2222-4d17-b009-af11009b9a1a",
"name": "Testauto",
"sendDateTime": "2022-09-15T07:26:32+00:00",
"type": "EmailMessage",
"source": "Automation",
"isTransactional": false,
"status": "Delivered",
"messageLink": "https://myurl.customer.staging.eclub.se/open/email/online/Eqyv1ICQF02wCa8FUKlejA/n0pgJu8BBkySna8RAHnP8w/8coDxC_inkCP_K8RAJuajA",
"messageText": "This is a test email."
}
]
}Note
The field messageLink contains an URL that leads you to a visualization of the message.
Note
The field messageText contains the full text for an SMS, or the subject line if it's an email.
Field definitions
Field name | Type | Description | Example value |
|---|---|---|---|
messageId | GUID | Unique message id | ea11fa26-54d7-4689-984e-ad4000d7a153 |
name | string | Name of the message in Voyado | 20210610_SE_Summer collection_VIP |
sendDateTime | datetime | Date and time when the message was sent with offset | 2021-06-100T09:42:44.537+02:00 |
type | string | Type of message (EmailMessage, SmsMessage or PostalMessage) | EmailMessage |
source | string | Where the message was sent from in Voyado Engage (Automation, Manual or System) | Manual |
isTransactional | boolean | If the message was sent as transactional or not (does not take opt-in into account) | false |
status | string | Delivery status of the send-out | Delivered |
messageLink | string | The URL for the web version of the email | https://[client].customer.voyado.com/open/email/online/mun9-f1vQEiZ-K1BAUB68Q/9DGtlvkQyka96qpVAMJ70A/m4L3rBllXEiPea1DALLg3A |
messageText | string | The text content of the SMS or the subject line of the email. | Check out our summer collection! |