Conversations

Get many conversation items

Changed on

Returns multiple conversation items by their IDs in a single request. Use this to fetch full details (summary, tags, recording, etc.) for items returned by the analytics drilldown or any other list.

post/v2/api/conversations/items/batch

Request

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

Request body

idsstring[] required

Array of conversation item IDs (max 100)

Response

Conversation items

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