Create and reply to a customer conversation via the Re:amaze API

Steps

1. Get an API token: in your Re:amaze account go to Settings > Developer > API Token and click 'Generate New Token'; every staff user has their own token and the API acts on behalf of that user.
2. Authenticate every request with HTTP Basic Auth ({login-email}:{api-token}) over HTTPS against your brand's host, e.g. https://{brand}.reamaze.io/api/v1/..., and send an Accept: application/json header (or suffix the URL with .json).
3. Create a new conversation with POST https://{brand}.reamaze.io/api/v1/conversations, passing a JSON body with conversation.subject, conversation.category (the Channel slug), conversation.message.body, and conversation.user (name/email); optionally include tag_list, status, data, or assignee.
4. Reply within an existing conversation with POST https://{brand}.reamaze.io/api/v1/conversations/{slug}/messages, passing message.body (Markdown supported) and message.visibility (0 = regular reply, 1 = internal note).
5. Optionally pass message.origin_id to dedupe messages, message.suppress_notifications / message.suppress_autoresolve / message.suppress_surveys to control side effects, and message.attachment/message.attachments (URLs) to include files.
6. Retrieve conversation history with GET https://{brand}.reamaze.io/api/v1/messages (all conversations) or scoped to one conversation, filtering with filter, tag, origin, category, start_date/end_date, and paginating via page/page_size.