curl "https://api.telzino.com/v1/chat/messages?agent_id=3f1c2a4e-8b7d-4c3a-9e2f-1a2b3c4d5e6f&visitor_id=v_9b1c5f3e2d1a0b9c" \
-H "Authorization: Bearer pk_live_..." \
-H "Origin: https://example.com"
{
"messages": [
{ "id": "6d0c8b8e-...", "role": "user", "text": "Do you open on Sunday?", "created_at": "2026-11-12T10:00:00Z" },
{ "id": "1a2b3c4d-...", "role": "agent", "text": "Yes, from 10am to 4pm.", "created_at": "2026-11-12T10:00:03Z" }
],
"pending": false
}
Chat
List Chat Messages
Read a visitor’s conversation with an agent, and whether a reply is coming
GET
/
v1
/
chat
/
messages
curl "https://api.telzino.com/v1/chat/messages?agent_id=3f1c2a4e-8b7d-4c3a-9e2f-1a2b3c4d5e6f&visitor_id=v_9b1c5f3e2d1a0b9c" \
-H "Authorization: Bearer pk_live_..." \
-H "Origin: https://example.com"
{
"messages": [
{ "id": "6d0c8b8e-...", "role": "user", "text": "Do you open on Sunday?", "created_at": "2026-11-12T10:00:00Z" },
{ "id": "1a2b3c4d-...", "role": "agent", "text": "Yes, from 10am to 4pm.", "created_at": "2026-11-12T10:00:03Z" }
],
"pending": false
}
Returns the visitor’s messages and the agent’s replies, oldest first. Poll it after sending a message until
pending is false. About once a second is right; the Chat SDK does this for you and slows down after errors.
Same publishable key and origin rules as Send Chat Message.
Query Parameters
Only messages created after this time, up to 100. Without it, the newest 100 messages.
curl "https://api.telzino.com/v1/chat/messages?agent_id=3f1c2a4e-8b7d-4c3a-9e2f-1a2b3c4d5e6f&visitor_id=v_9b1c5f3e2d1a0b9c" \
-H "Authorization: Bearer pk_live_..." \
-H "Origin: https://example.com"
{
"messages": [
{ "id": "6d0c8b8e-...", "role": "user", "text": "Do you open on Sunday?", "created_at": "2026-11-12T10:00:00Z" },
{ "id": "1a2b3c4d-...", "role": "agent", "text": "Yes, from 10am to 4pm.", "created_at": "2026-11-12T10:00:03Z" }
],
"pending": false
}
Response
A reply’s
created_at is when the agent started sending it, so it can be earlier than a message the visitor sent meanwhile. When polling with after, go back a couple of minutes from the newest message you have and skip ids you already showed. The SDK does this.