Get Conversation History

curl --request GET \
  --url https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "botIntegrationId": 123,
      "content": "Hi! I'd like to book an appointment.",
      "senderType": "user",
      "createdAt": "2024-01-15T14:30:00.000Z",
      "messageId": 789,
      "platformResourceId": "wamid.abc123",
      "latestStatus": "delivered",
      "failureReason": null,
      "errorCode": null,
      "errorTitle": null,
      "errorMessage": null,
      "errorDetails": null
    }
  ],
  "metadata": {
    "contextStartsAt": "2024-01-15T12:00:00.000Z"
  }
}

{
  "message": "Bad Request - Missing user number"
}

{
  "message": "Unauthorized"
}

{
  "message": "Not found"
}

GET

api

bot-integrations

{botIntegrationId}

conversations

Get Conversation History

curl --request GET \
  --url https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://chat.trysetter.com/api/v1/bot-integrations/{botIntegrationId}/conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "botIntegrationId": 123,
      "content": "Hi! I'd like to book an appointment.",
      "senderType": "user",
      "createdAt": "2024-01-15T14:30:00.000Z",
      "messageId": 789,
      "platformResourceId": "wamid.abc123",
      "latestStatus": "delivered",
      "failureReason": null,
      "errorCode": null,
      "errorTitle": null,
      "errorMessage": null,
      "errorDetails": null
    }
  ],
  "metadata": {
    "contextStartsAt": "2024-01-15T12:00:00.000Z"
  }
}

{
  "message": "Bad Request - Missing user number"
}

{
  "message": "Unauthorized"
}

{
  "message": "Not found"
}

Overview

This endpoint returns the complete message history for a contact’s conversation with your bot — every message sent by both the user and the bot, in chronological order, along with delivery status details. Use this to capture lead data, sync conversations to your CRM, or trigger downstream automations (e.g. in n8n or Make) whenever a conversation completes.

Authentication: Requires a Bearer token. Pass your API key in the Authorization header as Bearer <your-api-key>.

Bot Integration ID: The botIntegrationId in the path identifies a specific channel of a bot (its WhatsApp or SMS integration) — it is not the bot ID. Find it in the bot’s Integrations settings under the WhatsApp or Twilio integration. See Send Message for details.

Platform-specific parameters

The query parameter you need depends on your bot’s platform:

Platform	Required parameter
WhatsApp	`userNumber` — the contact’s phone number
SMS (Twilio)	`userNumber` — the contact’s phone number
Playground / Embed	`sessionId` — the session ID

Example request (WhatsApp)

curl -X GET \
  "https://chat.trysetter.com/api/v1/bot-integrations/123/conversations?userNumber=1234567890" \
  -H "Authorization: Bearer <your-api-key>"

Response

Each item in the data array is a single message:

senderType — "user" or "bot"
content — the message text
createdAt — ISO 8601 timestamp
latestStatus — delivery status (e.g. sent, delivered, read, failed)
failureReason / errorCode / errorMessage — populated only when latestStatus is failed

The metadata.contextStartsAt field indicates when the bot’s active context window begins. Messages before this timestamp are still returned in full but fall outside the bot’s current context.

Getting Your API Key

API keys can be generated from your Setter AI dashboard under Settings > API Keys. Keep your API key secure and never expose it in client-side code.

Authorizations

Authorization

string

header

required

Bearer token authentication using your API key

Path Parameters

botIntegrationId

integer

required

The ID of your bot integration

Query Parameters

userNumber

string

The contact's phone number (WhatsApp or SMS integrations)

sessionId

integer

The session ID (Playground or Embed integrations)

Response

Conversation history retrieved successfully

data

object[]

Show child attributes

metadata

object

Show child attributes

Getting Started

Guides

API Reference

Calendly Scheduling

Get Conversation History

Overview

Platform-specific parameters

Example request (WhatsApp)

Response

Getting Your API Key

Authorizations

Path Parameters

Query Parameters

Response

​Overview

​Platform-specific parameters

​Example request (WhatsApp)

​Response

​Getting Your API Key

Authorizations

Path Parameters

Query Parameters

Response

Overview

Platform-specific parameters

Example request (WhatsApp)

Response

Getting Your API Key