---
title: "Conversations"
description: "Retrieve conversation history for contacts"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.channelautomations.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Channel Automation API

Retrieve conversation history for contacts

## Operations

- [Get conversation history by phone number](/api/get-api-conversations-phone/)
- [Resume AI responses for a workspace contact](/api/post-api-ai-conversation-state-contact-id-resume/)
- [Pause AI and cancel queued AI replies for a workspace contact](/api/post-api-ai-conversation-state-contact-id-takeover/)
- [Get all conversations within a date range](/api/get-api-conversations-recent/)
- [List today's appointments mapped to the signed-in rep](/api/get-api-field-sales-appointments-today/)
- [List notes on one Sales Coach visit](/api/get-api-field-sales-appointments-id-notes/)
- [Add a note to one Sales Coach visit](/api/post-api-field-sales-appointments-id-notes/)
- [List notes on one visit from the Sales Coach iPhone app](/api/get-api-field-sales-rep-appointments-id-notes/)
- [Add a visit note from the Sales Coach iPhone app](/api/post-api-field-sales-rep-appointments-id-notes/)
- [Soft-delete a visit note](/api/delete-api-field-sales-appointments-id-notes-note-id/)
- [Edit a visit note](/api/patch-api-field-sales-appointments-id-notes-note-id/)
- [Soft-delete your own visit note from the iPhone app](/api/delete-api-field-sales-rep-appointments-id-notes-note-id/)
- [Edit your own visit note from the iPhone app](/api/patch-api-field-sales-rep-appointments-id-notes-note-id/)
- [Judge the newest ~30 s of an in-progress visit against the sales process](/api/post-api-field-sales-rep-live-steps/)
- [Record a rep-initiated device-location check-in for one assigned visit](/api/post-api-field-sales-appointments-id-checkin/)
- [One location reading while a checked-in Sales Coach visit is open](/api/post-api-field-sales-appointments-id-presence/)
- [The rep's reason for leaving a visit before the minimum](/api/post-api-field-sales-appointments-id-leave-reason/)
- [Visits happening right now ("In the field"), for managers](/api/get-api-field-sales-visits-live/)
- [Suggest three short texts a manager could send the rep at this visit](/api/post-api-field-sales-visits-appointment-id-message-suggest/)
- [Text the rep at this visit from the workspace number](/api/post-api-field-sales-visits-appointment-id-message/)
- [List Sales Coach visit assignments and latest check-ins for one contact](/api/get-api-field-sales-appointments-assignments/)
- [Explicitly map one assigned Sales Coach visit address](/api/post-api-field-sales-appointments-id-map-address/)
- [Erase one visit's location-derived check-in evidence, live step progress, coaching texts and mapped target](/api/delete-api-field-sales-appointments-id-location-evidence/)
- [Assign or unassign a Sales Coach visit](/api/put-api-field-sales-appointments-id-assignment/)
- [List visible field-sales conversations](/api/get-api-field-sales-conversations/)
- [Register a field-sales recording upload](/api/post-api-field-sales-conversations/)
- [List only the signed-in rep's currently assigned visit reviews](/api/get-api-field-sales-rep-conversations/)
- [Register an assigned visit recording with safe retries](/api/post-api-field-sales-rep-conversations/)
- [Verify an upload and queue conversation processing](/api/post-api-field-sales-conversations-id-finalize/)
- [Finalize the rep's own actively assigned visit recording](/api/post-api-field-sales-rep-conversations-id-finalize/)
- [Queue an existing workspace call recording for Field Coach analysis](/api/post-api-field-sales-existing-calls-analyze/)
- [Search contacts the caller may link to a recording](/api/get-api-field-sales-contacts-search/)
- [Get transcript, analysis, and score for a conversation](/api/get-api-field-sales-conversations-id/)
- [Delete a conversation and queue erasure of its audio and analysis](/api/delete-api-field-sales-conversations-id/)
- [Get the signed-in rep's own visit review (native Sales Coach)](/api/get-api-field-sales-rep-conversations-id/)
- [Delete the rep's own currently assigned visit recording](/api/delete-api-field-sales-rep-conversations-id/)
- [Create a short-lived private playback URL](/api/post-api-field-sales-conversations-id-playback/)
- [Read the workspace scorecard and its version history](/api/get-api-field-sales-scorecard/)
- [Publish a new scorecard version](/api/put-api-field-sales-scorecard/)
- [Read the workspace's Sales Coach arrival alert settings](/api/get-api-field-sales-arrival-alert-settings/)
- [Save the workspace's Sales Coach arrival alert settings](/api/put-api-field-sales-arrival-alert-settings/)
- [Preview the arrival alert email with this workspace's name and logo and sample visit details](/api/get-api-field-sales-arrival-alert-settings-preview/)
- [Send a sample arrival alert to the signed-in user's own email](/api/post-api-field-sales-arrival-alert-settings-test/)
- [Read what the Sales Coach settings page shows about field readiness](/api/get-api-field-sales-settings-overview/)
- [Read the workspace's auto-analyze rules](/api/get-api-field-sales-auto-analyze-settings/)
- [Save the workspace's auto-analyze rules](/api/put-api-field-sales-auto-analyze-settings/)
- [Mark a conversation for QA review](/api/post-api-field-sales-conversations-id-qa-flag/)
- [List QA flags (the review queue)](/api/get-api-field-sales-qa-flags/)
- [Resolve a QA flag with a human verdict](/api/post-api-field-sales-qa-flags-id-verdict/)
- [Rep acknowledges a coaching verdict](/api/post-api-field-sales-qa-flags-id-acknowledge/)
- [List QA notes on a conversation](/api/get-api-field-sales-conversations-id-qa-notes/)
- [Add a QA note to a conversation](/api/post-api-field-sales-conversations-id-qa-notes/)
- [Delete a QA note](/api/delete-api-field-sales-conversations-id-qa-notes-note-id/)
- [Edit a QA note](/api/patch-api-field-sales-conversations-id-qa-notes-note-id/)
- [Re-run transcription and analysis, publishing a new version](/api/post-api-field-sales-conversations-id-reprocess/)
- [Generate editable SMS and email follow-up drafts](/api/post-api-field-sales-conversations-id-followup/)
- [Save a rep's edit of a follow-up draft](/api/patch-api-field-sales-followups-id/)
- [Start an optional Allison Live voice session](/api/post-api-openai-live-session/)


Source: https://developer.channelautomations.com/api/tags/conversations/index.md