Conversations

Get conversation item

Changed on

Returns a single call or SMS message by its ID.

get/v2/api/conversations/items/{id}

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/conversations/items/{id}
  • Auth
    API key in header Authorization

Path parameters

idstring required
Example:cll-abc123

Item ID (cll-* for calls, msg-* for messages)

Query parameters

extendstring
Example:transcript

Comma-separated optional fields. Supported: transcript

Response

Conversation item

Example response

{
  "data": {
    "id": "cll-abc123",
    "allo_number": "+14155550100",
    "contact_number": "+14155551234",
    "contacts": [
      {
        "id": "cnt-abc123",
        "name": "Sarah Johnson",
        "company": {
          "id": "com-xyz789",
          "name": "Acme Corp"
        },
        "deals": [
          {
            "id": "dea-def456",
            "name": "Enterprise Plan"
          }
        ]
      }
    ],
    "user": {
      "id": "usr-abc123",
      "name": "John",
      "email": "john@acme.com"
    },
    "extracted_data": {
      "contact": {
        "name": "Marie Dupont",
        "company": "Vibrant Events",
        "job_title": "Office manager",
        "website": "vibrantevents.com",
        "address": "12 rue de la Paix, Paris",
        "emails": [
          "marie@vibrantevents.com"
        ]
      }
    }
  }
}

Changes

    • warning

      added the new BLOCKED enum value to the / response property for the response status

    • warning

      added the new CLOSED enum value to the / response property for the response status

    • warning

      added the new FAILED enum value to the / response property for the response status

    • warning

      added the new FAILED_EXTERNAL enum value to the / response property for the response status

    • warning

      added the new RECEIVED enum value to the / response property for the response status

    • warning

      added the new TRANSFERRED_AI enum value to the / response property for the response status

    • warning

      added the new TRANSFERRED_EXTERNAL enum value to the / response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      removed the TRANSFERRED enum value from the / response property for the response status