Contacts
Send a message to a contact
Sends an SMS, WhatsApp or email to a contact. The message joins the contact's open ticket or opens one. Email accepts cc, bcc and upload_ids, and WhatsApp outside the 24-hour reply window needs an approved template_id.
Requires: desk.write scope, Converse licence.
Authorization
bearerAuth AuthorizationBearer <token>
A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.
In: header
Path Parameters
id*string
The contact's id (a UUID).
Request Body
application/json
Response
Created
Example
{ "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "ticket": { "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37", "ref": "TCK-4471", "opened": false }, "delivery": "delivered", "error": "", "replayed": false}FieldTypeDescription
idrequiredstring (uuid)ticketrequiredobjectThe ticket the call belongs to, by id or reference such as TCK-4471.idrequiredstring (uuid)refrequiredstringopenedrequiredbooleandeliverystringerrorstringreplayedbooleancurl -X POST "https://api.sautidesk.com/v1/desk/contacts/string/messages" \ -H "Content-Type: application/json" \ -d '{ "channel": "whatsapp", "body": "Your parcel is out for delivery today." }'