API REST

Conversations

Liste les conversations et envoie des messages.

Lister les conversations

GET/api/v1/conversations

Liste les conversations avec pagination. Filtre par lead, canal ou statut.

curl -X GET "https://settyn.com/api/v1/conversations?status=active" \
  -H "Authorization: Bearer YOUR_API_KEY"

Réponse

{
  "data": [
    {
      "id": "conv_xyz789",
      "leadId": "lead_abc123",
      "channel": "instagram",
      "status": "active",
      "lastMessageAt": "2026-04-07T09:15:00Z",
      "messageCount": 12
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total": 58 }
}

Envoyer un message

POST/api/v1/conversations

Envoie un message dans une conversation existante ou en crée une nouvelle.

leadIdstringrequis

Identifiant du lead.

channelstringrequis

Canal : instagram, whatsapp…

messagestringrequis

Contenu du message.

curl -X POST https://settyn.com/api/v1/conversations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "leadId": "lead_abc123",
    "channel": "instagram",
    "message": "Salut ! On planifie un call cette semaine ?"
  }'

Cette page a-t-elle été utile ?

Settyn by Welwitech