Skip to main content
GET
/
v1
/
conversations
Lister les conversations
curl --request GET \
  --url https://api.setteo.io/v1/conversations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 456,
      "platform": "whatsapp",
      "agent_id": "agent_abc123",
      "agent_name": "Assistant commercial",
      "ai_stopped": false,
      "lead": {
        "id": 123,
        "ext_id": "crm_123",
        "first_name": "Jean",
        "last_name": "Dupont",
        "username": "jdupont",
        "image": "https://example.com/avatar.jpg",
        "email": "jean.dupont@example.com",
        "phone": "+33612345678",
        "source": "api",
        "warmth": "warm",
        "pipeline_stage": "qualified",
        "variables": {
          "plan": "pro"
        },
        "whatsapp_phone_number_id": 12,
        "created_at": "2026-07-08T12:00:00Z",
        "updated_at": "2026-07-08T12:00:00Z",
        "tags": [
          {
            "id": 1,
            "label": "Prospect chaud",
            "description": "Prospect prêt à réserver un appel.",
            "pipeline_stage": "qualified",
            "created_at": "2026-07-08T12:00:00Z",
            "updated_at": "2026-07-08T12:00:00Z"
          }
        ]
      },
      "messages": [
        {
          "id": 789,
          "conversation_id": 456,
          "direction": "inbound",
          "message": "Bonjour, je souhaite en savoir plus.",
          "has_link": false,
          "is_ai_generated": true,
          "timestamp": "2026-07-08T12:10:00Z"
        }
      ]
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 4,
    "path": "https://api.setteo.io/v1/leads",
    "per_page": 25,
    "to": 25,
    "total": 83
  }
}

Authorizations

Authorization
string
header
required

Token API généré depuis votre espace de travail Setteo.

Query Parameters

page
integer
default:1

Numéro de page.

Required range: x >= 1
per_page
integer
default:25

Nombre de résultats par page.

Required range: 10 <= x <= 100
lead_id
integer

Filtre par identifiant de prospect.

Required range: x >= 1
lead_phone
string

Filtre par téléphone de prospect.

last_message_after
string<date-time>

Filtre de date.

last_message_before
string<date-time>

Filtre de date.

last_inbound_message_after
string<date-time>

Filtre de date.

last_inbound_message_before
string<date-time>

Filtre de date.

last_outbound_message_after
string<date-time>

Filtre de date.

last_outbound_message_before
string<date-time>

Filtre de date.

Response

Liste paginée de conversations.

data
object[]
required
meta
object
required