Skip to main content
GET
/
v1
/
conversations
/
{phone}
Obtenir une conversation par téléphone
curl --request GET \
  --url https://api.setteo.io/v1/conversations/{phone} \
  --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"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

phone
string
required

Téléphone du prospect.

Example:

"+33612345678"

Response

Conversation trouvée.

data
object
required