> For the complete documentation index, see [llms.txt](https://dev.apirtc.com/apirtc-developer-portal/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.apirtc.com/apirtc-developer-portal/rest-apis-and-integration/apizee-api-rest-description/session-events-api.md).

# Session Events API

This documentation describes how to interact with the Apizee API to retrieve events that occur during video sessions ("video-assistance").

## Introduction

Apizee sessions can include interactions such as OCR scans, chat messages, media captures, or survey completions. Until now, this data was not accessible externally.

With the new **Session Events API**, all meaningful in-session actions are exposed via:

* a REST API attached to each ticket
* a webhook that triggers on each new event

These capabilities enable IT systems to:

* Monitor what happens during video sessions
* Automate processes based on session content
* Archive or analyze interaction data

## Authentication and Permissions

Access to these endpoints requires:

* A valid Bearer token
* Proper role permissions to access ticket data

See [Introduction](https://dev.apirtc.com/apirtc-developer-portal/rest-apis-and-integration/introduction.md#authentication) for a step by step documentation.

> Rate limiting applies to all event endpoints. See [Rate Limits](https://dev.apirtc.com/apirtc-developer-portal/rest-apis-and-integration/rate-limits.md) for more details.

## Event Model

Each event in the ticket timeline follows a common structure plus event-specific attributes.

### Event-specific payload attributes

Depending on the event type triggered, the webhook payload will contain specific attributes:

<table><thead><tr><th>Event type</th><th>Props value example</th></tr></thead><tbody><tr><td>consent.accepted</td><td></td></tr><tr><td>ticket.sessionStarted</td><td></td></tr><tr><td>geo.ansAllowed</td><td><pre><code> "geoloc":{
</code></pre></td></tr><tr><td>"lat": 48.650032799999998,</td><td></td></tr><tr><td>"lng": -3.3655395000000001</td><td></td></tr><tr><td>}</td><td></td></tr><tr><td></td><td></td></tr><tr><td>geo.ansDisallowed</td><td></td></tr><tr><td>ticket.approved</td><td><pre><code>"agent": {
</code></pre></td></tr></tbody></table>

```
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
```

}, | | ticket.new |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | ticket.assigned |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | ticket.completed |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | ticket.cancelled |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | ticket.closed |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | mediaDevice.allowed |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | mediaDevice.disallowed |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | mediaDevice.cameraAllowed |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | mediaDevice.cameraDisallowed |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | mediaDevice.micAllowed |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | mediaDevice.micDisallowed |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | session.established |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | ticket.priorityChanged |

```
"agent": {
"email": "francois.legoff.ext@apizee.com",
"phone": "",
"firstname": "François",
"lastname": "Le Goff"
},
"oldPriority": 1,
"newPriority": 0
```

\| | ticket.invitationSent |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | ticket.invitationResent |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | ticket.invitationAccepted |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | ticket.invitationDeclined |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | ~~ticket.invitationExpired~~ | | | ticket.invitationClicked |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | ticket.invitationNotclicked |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | session.agentContacted |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | media.pictureTaken |

```
“mediaId”: 342432
```

\| | media.pictureSent |

```
“mediaId”: 342432
```

\| | survey.answered |

```
"requestor": {
"email": "contact@flegoff.fr",
"phone": "",
"firstname": "",
"lastname": "contact Flegoff"
},
"surveyAnswer": {
"questions" : [
{"id":12, //SurveyQuestionAnswer id
"label": {"fr":"Première question ?","en":"Question one?"},
"answer": "Not satisfied" //Not satisfied, Satisfied, Very satisfied
},
{"id":14,
"label": {"fr":"Deuxième question ?","en":"Question two?"},
"answer": "Satisfied" //Not satisfied, Satisfied, Very satisfied
}
],
"feedback": "Ceci est un feedback"

}
```

\| | session.agentLeft |

```
"agent": {
"email": "john.doe@apizee.com",
"phone": "+3316565454",
"firstname": "John",
"lastname": "Doe"
},
```

\| | session.userLeft |

```
"requestor": {
"email": "jane.doe@issues.llc",
"phone": "0605040302",
"firstname": "Jane",
"lastname": "Doe"
},
```

\| | media.OCRDone |

```
"text": "Lorem\nipsum"
```

|

## HTTP REST API to access to ticket's events

## GET /api/v3/tickets/{ticketId}/events

> Get an event list for a ticket.

```json
{"openapi":"3.0.0","info":{"title":"Apizee Cloud API documentation","version":"3.0"},"tags":[{"name":"tickets","description":"API to manage tickets"}],"servers":[{"url":"https://cloud.apizee.com/","description":"Default server"}],"security":[{"access_token":[]}],"components":{"securitySchemes":{"access_token":{"type":"http","description":"Please fill in the field with the token obtained after authentication using the /token method","scheme":"bearer"}}},"paths":{"/api/v3/tickets/{ticketId}/events":{"get":{"tags":["tickets"],"summary":"Get an event list for a ticket.","operationId":"api.v3.tickets.events","parameters":[{"name":"ticketId","in":"path","description":"ID of the wanted ticket","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Good case","content":{"application/json":{"schema":{}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found case","content":{"application/json":{"schema":{}}}}}}}}}
```

## Listen to webhook callbacks

The `conversationevent.create` webhook notifies your system in real time whenever a new event occurs during a video session linked to a support ticket. It enables your backend to react immediately to user interactions such as media capture, OCR scans, or survey responses.

#### How It Works

Once configured, the webhook is triggered for each new event in a ticket's timeline. Your endpoint receives a `POST` request with a JSON payload describing the event.

#### Example Payload

```json
{
  "event": "create",
  "time": 1749581447,
  "object": "conversationevent",
  "objectId": 1266,
  "props": {
    "eventType": "media.OCRDone",  // <-- common payload attribute
    "eventCode": 41,  // <-- common payload attribute
    "conversationId": 548,  // <-- common payload attribute
    "ticketId": 361,  // <-- common payload attribute
    "text": "text captured by OCR" // <-- event-specific attribute
    }
}
```

#### Payload Fields

{% hint style="info" %}
To get a complete list of the webhooks payload attributes and how to configure webhooks, please refer to [Webhooks](https://dev.apirtc.com/apirtc-developer-portal/rest-apis-and-integration/webhooks.md).
{% endhint %}
