Get Conversation Thread — DeltaLead REST API Reference

Fetch a single conversation by its unique identifier to get the complete message thread, channel metadata, and the AI-generated summary that DeltaLead produces after each interaction. Use this endpoint to embed conversation history inside your CRM records, audit AI responses, or display the full context to a sales advisor before they take over from the AI agent.

Endpoint

GET https://platform-api.deltalead.ai/v1/conversations/{id}

Path Parameters

string

required

The unique identifier of the conversation to retrieve, e.g. conv_xyz789. You can obtain conversation IDs from the List Conversations endpoint or from webhook payloads.

Example Request

cURL

curl https://platform-api.deltalead.ai/v1/conversations/conv_xyz789 \
  -H "X-API-Key: YOUR_API_KEY"

Response

A successful request returns HTTP 200 OK with the conversation object, a nested messages array containing the full message history, and an ai_summary field.

200 OK

{
  "id": "conv_xyz789",
  "lead_id": "lead_abc123",
  "channel": "whatsapp",
  "status": "transferred",
  "created_at": "2024-03-10T14:22:05Z",
  "updated_at": "2024-03-11T09:05:33Z",
  "last_message_at": "2024-03-11T09:05:33Z",
  "ai_summary": "Lead is highly interested in the Toyota Hilux SRX 2024 in black. Confirmed budget around US$45,000. Requested financing options and a test drive for this week. Conversation transferred to human advisor for follow-up on financing.",
  "messages": [
    {
      "id": "msg_001",
      "conversation_id": "conv_xyz789",
      "direction": "inbound",
      "type": "text",
      "content": "Hola! Vi la Hilux SRX 2024 que tienen publicada, ¿sigue disponible en negro?",
      "sent_by": "lead",
      "created_at": "2024-03-10T14:22:05Z"
    },
    {
      "id": "msg_002",
      "conversation_id": "conv_xyz789",
      "direction": "outbound",
      "type": "text",
      "content": "¡Hola María! 👋 Sí, la Hilux SRX 2024 en negro sigue disponible. ¿Querés que te cuente las opciones de financiación o preferís coordinar un test drive?",
      "sent_by": "ai_agent",
      "created_at": "2024-03-10T14:22:13Z"
    },
    {
      "id": "msg_003",
      "conversation_id": "conv_xyz789",
      "direction": "inbound",
      "type": "text",
      "content": "Me interesa la financiación, tengo un presupuesto de unos 45000 dólares.",
      "sent_by": "lead",
      "created_at": "2024-03-10T14:25:40Z"
    },
    {
      "id": "msg_004",
      "conversation_id": "conv_xyz789",
      "direction": "outbound",
      "type": "text",
      "content": "Perfecto, María. Para darte las mejores opciones de financiación te voy a conectar con uno de nuestros asesores. Te contactan en breve. 🙌",
      "sent_by": "ai_agent",
      "created_at": "2024-03-10T14:25:48Z"
    }
  ]
}

Response Fields

string

Unique identifier of the conversation, prefixed with conv_.

string

ID of the lead this conversation belongs to.

string

Channel on which the conversation occurred. One of whatsapp, facebook, instagram, email, phone.

string

Current status: open, closed, or transferred.

string

AI-generated plain-text summary of the conversation. Updated after each AI turn. Highlights vehicle interest, budget, urgency signals, and any action items for the sales team.

array

Ordered array of message objects, from oldest to newest.

Show Message object fields

string

Unique identifier of the message, prefixed with msg_.

string

ID of the conversation this message belongs to.

string

inbound for messages sent by the lead; outbound for messages sent by DeltaLead (AI agent or human advisor).

string

Media type of the message. One of text, audio, image, document.

string

Text body of the message. For audio, image, and document types, this field contains a URL to the media file.

string

Who originated this message. One of ai_agent, human, lead.

string

ISO 8601 timestamp of when the message was sent or received.

Phone conversations use a transcript field instead of a messages array. The transcript is a structured text block generated from the call recording and contains speaker labels (e.g., Agent: / Lead:), timestamps, and the full dialogue. All other conversation fields remain identical.

Overview

Leads

Conversations

Agents

Webhooks

Get Conversation Thread — DeltaLead REST API Reference

Endpoint

Path Parameters

Example Request

Response

Response Fields

​Endpoint

​Path Parameters

​Example Request

​Response

​Response Fields

Endpoint

Path Parameters

Example Request

Response

Response Fields