Open API v1

Send a message into a conversation

A conversation is an inbox thread (web chat, email, or a social channel).

Required scopes: conversations:read to list, messages:write to send.

Find the thread

bash

curl "https://api.taggoai.com/open/v1/conversations?contact_id=CONTACT_ID&status=open" \
  -H "Authorization: Bearer tg_live_YOUR_KEY"

Read messages

bash

curl "https://api.taggoai.com/open/v1/conversations/CONVERSATION_ID/messages?limit=20" \
  -H "Authorization: Bearer tg_live_YOUR_KEY"

Messages are newest first. Internal notes are included.

Reply

This posts an agent reply the same way the dashboard does.

bash

curl -X POST https://api.taggoai.com/open/v1/conversations/CONVERSATION_ID/messages \
  -H "Authorization: Bearer tg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Your order shipped this morning. Tracking is VN123." }'

To keep a note off the customer thread:

json

{ "body": "Called the warehouse. ETA Friday.", "internal_note": true }