> For the complete documentation index, see [llms.txt](https://docs.iadvize.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iadvize.dev/~/changes/39J6v2tWi3Ms7Me1qEFP/technologies/api-and-webhooks/desk-events/reference.md).

# Reference

<table><thead><tr><th width="345.3333333333333">Event</th><th>Description</th></tr></thead><tbody><tr><td><a href="#conversation_added">CONVERSATION_ADDED</a></td><td>A new conversation pops in the operator's desk or the desk is refreshed with a previously opened conversation.</td></tr><tr><td><a href="#conversation_focused">CONVERSATION_FOCUSED</a></td><td><p>The conversation gets the focus because: </p><p>- It’s the only one on the iAdvize desk </p><p>- The operator clicks on it</p><p>- Another conversation is removed from the desk and this conversation is "elected" to receive the focus</p></td></tr><tr><td><a href="#conversation_focus_lost">CONVERSATION_FOCUS_LOST</a></td><td>The operator clicks on another conversation or the operator closes, snoozes or transfers the conversation.</td></tr><tr><td><a href="#conversation_state_box_clicked">CONVERSATION_STATE_BOX_CLICKED</a></td><td>Triggered each time the operator clicks on a state box (=“conversation tab” on the left)</td></tr><tr><td><a href="#conversation_visitor_updated">CONVERSATION_VISITOR_UPDATED</a></td><td><p>Triggered each time iAdvize discovers new information about the visitor: </p><p>- When the conversation is added to the iAdvize desk </p><p>- When the visitor authenticates (even during a conversation) </p><p>- When the operator edits the visitor's information from the console </p><p>- etc. </p><p></p></td></tr><tr><td><a href="#conversation_removed">CONVERSATION_REMOVED</a></td><td>The conversation disappears from the desk because the conversation is closed, snoozed, or transferred.</td></tr></tbody></table>

## CONVERSATION\_ADDED

<pre class="language-json"><code class="lang-json">CONVERSATION_ADDED { 
<strong>    "event": "com.iadvize.desk.CONVERSATION_ADDED", 
</strong>    "conversationId": "c1750366-9483-4372-a57d-844da14071c6", 
    "projectId": 1234 
}
</code></pre>

## CONVERSATION\_FOCUSED

<pre class="language-json"><code class="lang-json">CONVERSATION_FOCUSED { 
<strong>    "event": "com.iadvize.desk.CONVERSATION_FOCUSED", 
</strong>    "conversationId": "c1750366-9483-4372-a57d-844da14071c6" 
}

</code></pre>

## CONVERSATION\_FOCUS\_LOST

```json
CONVERSATION_FOCUS_LOST { 
    "event": "com.iadvize.desk.CONVERSATION_FOCUS_LOST", 
    "conversationId": "c1750366-9483-4372-a57d-844da14071c6" 
}
```

## CONVERSATION\_STATE\_BOX\_CLICKED

<pre class="language-json"><code class="lang-json">CONVERSATION_STATE_BOX_CLICKED { 
    "event": "com.iadvize.desk.CONVERSATION_STATE_BOX_CLICKED", 
<strong>    "conversationId": "93d86726-aaf7-4962-877e-104c577d86ae" 
</strong>}
</code></pre>

## CONVERSATION\_VISITOR\_UPDATED

```json
CONVERSATION_VISITOR_UPDATED { 
    "event": "com.iadvize.desk.CONVERSATION_VISITOR_UPDATED", 
    "conversationId": "c1750366-9483-4372-a57d-844da14071c6", 
    "visitor": { 
        ...allKnownIAdvizeFields 
    } 
} 
```

{% hint style="info" %}
The `allKnownIAdvizeFields` refers to the visitor fields available in an iAdvize visitor profile.
{% endhint %}

## CONVERSATION\_REMOVED

```json
CONVERSATION_REMOVED { 
    "event": "com.iadvize.desk.CONVERSATION_REMOVED", 
    "conversationId": "c1750366-9483-4372-a57d-844da14071c6" 
}
```