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.
Key concepts
Conversation — a summary of interactions with a contact_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
Conversation summaries with the last interaction per contact number
Full detail for a single call or SMS
Search calls and SMS across all conversations
Fetch multiple items by ID in a single request
Mark as read, unread, archive, or unarchive a conversation