Messages & Conversations

Messages & Conversations The Messages API lets you send a message to any contact, read back a conversation, pull a full chat-session thread, and mark messages as read — all without opening the inbox. All paths on this page are relative to the base URL https://api.relaytiv.com/v1 . Every request needs your API key — see Authentication for the full list of ways to send it. The examples below use the X-API-Key header, with one cURL example showing the ?apiKey= query form too. How delivery works: Sending a message does not wait for it to arrive. The API accepts your message, returns immediately with a message ID, and then delivers it in the background on the contact's channel (WhatsApp, SMS, Instagram, and so on). To track whether a message was actually delivered or read, listen for status updates with Webhooks — don't poll. The send response only confirms the message was accepted. Send a message There are two ways to send. Pick whichever fits how you already identify the contact: Send by contact ID — you already know the contact's ID (for example, you created the contact through the API or got it from a webhook). Use POST /contacts/{contactId}/send-message . Send by contact identity — you know the contact's phone number, Instagram ID, etc., but not their internal ID. Use POST /contacts/send and let the platform find the right contact. Both queue the message the same way and deliver it on whichever channel the contact is on. You don't pick a transport — the platform routes Wh