The Conversations API provides a unified view of all calls and SMS messages, grouped by contact phone number. A “conversation” is the full history of interactions between your Allo number(s) and an external phone number.Documentation Index
Fetch the complete documentation index at: https://help.withallo.com/llms.txt
Use this file to discover all available pages before exploring further.
Key concepts
Conversation — a summary of interactions with acontact_number, including the matched contacts and the last interaction (last call, last SMS). Use the /items endpoints to access the full history.
Conversation item — a single call or SMS message. Use the search or get endpoints to retrieve full item details including transcripts, summaries, and recordings.
Contact matching — each conversation includes matched contacts with their company and deal information. A phone number can match zero, one, or multiple contacts.
Keyword search — search endpoints support keyword search across call transcripts, summaries, and SMS content. Use sort=RELEVANCE to order results by relevance.
Extend — use ?extend=transcript to include full call transcripts on items. Transcripts are excluded by default to keep responses lightweight.
Endpoints
List conversations
Conversation summaries with the last interaction per contact number
Get conversation item
Full detail for a single call or SMS
Search conversation items
Search calls and SMS across all conversations
Get many conversation items
Fetch multiple items by ID in a single request
Execute conversation action
Mark as read, unread, archive, or unarchive a conversation