Announcing Conversation Log API release: Unified and realtime conversation data access

<div>
<table class="wysiwyg-table ck-table-resized wysiwyg-table-resized" style="width: 100%; margin-right: auto; margin-left: auto;">
<colgroup>
<col style="width: NaN%;">
<col style="width: NaN%;">
<col style="width: NaN%;">
</colgroup>
<tbody>
<tr>
<td><span style="color: #16140c;"><strong>Announced on</strong></span></td>
<td><span style="color: #16140c;"><strong>Rollout starts</strong></span></td>
<td><span style="color: #16140c;"><strong>Rollout ends</strong></span></td>
</tr>
<tr>
<td><span style="color: #16140c;">May 23, 2025</span></td>
<td><span style="color: #16140c;">May 23, 2025</span></td>
<td><span style="color: #16140c;">May 23, 2025</span></td>
</tr>
</tbody>
</table>
</div>
<p>We’re excited to introduce the <strong>Conversation Log API</strong>, designed to address key challenges in reporting and customer escalations by providing a unified, flexible solution for accessing raw ticket and message data.</p>
<p>This announcement covers the following topics:</p>
<ul>
<li>What is changing?</li>
<li>Why is Zendesk making this change?</li>
<li>What do I need to do? </li>
</ul>
<h2 id="h_01JVY836B2DZK98W45PMWX6V8F"><strong>What’s Changing and Why?</strong></h2>
<p>The <strong>Conversation Log API</strong> is a new offering from Zendesk that provides a unified way to access all conversation events across different channels. Customers can now retrieve real-time details of messaging conversations.</p>
<p>We’ve released the <strong>Conversation Log API</strong> to address the following key customer concerns:</p>
<ol>
<li>Unified Schema and Real-Time Access to Conversation Data
<ul>
<li>Enterprise customers need seamless integration of conversation data with third-party BI tools.</li>
<li>Currently, customers rely on Ticket Audit APIs and SunCo APIs, which involve cost implications and usability challenges, such as inconsistent time formats across events.</li>
<li>The Conversation Log API delivers a unified schema and real-time data access, resolving these issues.</li>
</ul>
</li>
<li>Custom Reporting
<ul>
<li>Unlike chat, which lacks real-time API access for conversations, the Conversation Log API enables customers to build custom dashboards in their BI tools, ensuring parity and flexibility.</li>
</ul>
</li>
<li>Advanced Workflow Automation
<ul>
<li>Customers can trigger workflows based on conversation data properties. For example, they can tag conversations as spam using their models and automatically close them via triggers, streamlining operations.</li>
</ul>
</li>
</ol>
<h2 id="h_01JVY84PXFFKW8YG0S66R646GY">Key customer capabilities </h2>
<p>The <strong>Conversation Log API</strong> provides a robust, unified interface for accessing and managing conversation events across all Zendesk channels in real time. Built to address enterprise needs for seamless data integration and automation, its key capabilities include:</p>
<ul>
<li>
<strong>Unified Event Access Across Channels</strong>:
<ul>
<li>Retrieve a comprehensive log of conversation events, such as messages sent or received, conversation status changes (e.g., opened, closed), and user interactions (e.g., customer joins or leaves), across all supported channels, including web, mobile, and social messaging platforms like WhatsApp. Events are delivered in a standardized JSON format, ensuring consistency and ease of integration with external systems or third-party BI tools.</li>
</ul>
</li>
<li>
<strong>Real-Time Data Retrieval</strong>:
<ul>
<li>Access conversation data in real time, enabling immediate insights and actions. This supports use cases like live monitoring, custom dashboards, or triggering automated workflows based on conversation updates. The API supports filtering by conversation ID or time range, allowing precise data retrieval.</li>
</ul>
</li>
<li>
<strong>Granular Event Details</strong>:
<ul>
<li>Capture detailed event properties, including:
<ul>
<li>
<strong>Message Content</strong>: Text, attachments, or structured messages (e.g., buttons, quick replies).</li>
<li>
<strong>Sender and Recipient Information</strong>: Identifiers for agents, customers, or bots, including user IDs and channel-specific details.</li>
<li>
<strong>Timestamps</strong>: Consistent UTC timestamps for accurate event tracking.</li>
<li>
<strong>Channel Metadata</strong>: Specific details like WhatsApp phone numbers or web widget session IDs.</li>
<li>
<strong>Event Types</strong>: Includes MessageSent, MessageReceived, ConversationOpened, ConversationClosed, CustomerJoined, and more, covering the full lifecycle of a conversation.</li>
</ul>
</li>
</ul>
</li>
</ul>
<p>For more details on the capabilities please refer to <a href="https://developer.zendesk.com/documentation/ticketing/reference-guides/conversation-log-events-reference/"><span class="wysiwyg-underline">Zendesk Developer Center</span></a></p>
<h2 id="h_01JVY87AWHCATR4HSHT6K62ZS5">What do I need to do?</h2>
<p>To start using the <strong>Conversation Log API</strong>, explore our comprehensive documentation at<a href="https://developer.zendesk.com/documentation/ticketing/reference-guides/conversation-log-events-reference/"><span class="wysiwyg-underline"> Zendesk Developer Center</span></a>. As this is a new API, no additional setup or action is required—just dive in and integrate it into your workflows!</p>
<p><span style="color: #16140c;">If you have feedback or questions about this announcement, visit our </span><a href="https://support.zendesk.com/hc/en-us/community/topics/1260801854210">community forum,</a><span style="color: #16140c;"> where we collect and manage customer product feedback. For general assistance with your Zendesk products, contact </span><a href="https://support.zendesk.com/hc/en-us/articles/4408843597850"><span class="wysiwyg-underline">Zendesk Customer Support</span></a><span style="color: #16140c;">.</span></p>