livechat-transcript-1.md

Send Livechat Transcript

This endpoint is used by agents and managers to schedule an email transcript to be sent once the chat is closed.

{% hint style="info" %}

• It requires the send-omnichannel-chat-transcript permission.
• The room must be opened. {% endhint %}

HTTP Method	URL	Requires Auth
POST	/api/v1/livechat/transcript/:rid	yes

Path Variables

Key	Example Value	Description
rid*	tcbbSmWSLR5uo5PBW	The room ID.

Body Parameters

Key	Example Value	Description
email*	fim@rocket.chat	The email address where the transcript should be sent.
subject*	Test request Transcript	The subject of the email.

Example Call

curl -L -X POST 'http://localhost:3000/api/v1/livechat/transcript/AHsFiNLYWQK35jgtS" \
-H 'x-auth-token: qlHA60g5JQjJJG7C_8MgXoFnOiRQ8X9TWVVq4AcQeFb' \
-H 'x-user-id: rbAXPnMktTFbNpwtJ' \
-H 'Content-Type: application/json' \
--data-raw '{
    "email":"funke@test.com",
    "subject":"Livechat Transcript"
}'

Example Response

Success

{
  "success": true
}

Error

Any of the following errors can occur on the endpoint.

• Authorization: Requires an authentication token for the request to be made.
• No Permission: Occurs when the authenticated user doesn't have send-omnichannel-chat-transcript permission.
• Transcript Requested: Occurs when a transcript has been requested for this room. See livechat-transcript-2.md and delete the current request before requesting the transcript again.

{% tabs %} {% tab title="Authorization" %}

{
    "status": "error",
    "message": "You must be logged in to do this."
}

{% endtab %}

{% tab title="No Permission" %}

{
    "success": false,
    "error": "User does not have the permissions required for this action [error-unauthorized]"
}

{% endtab %}

{% tab title="Transcript Requested" %}

{
    "success": false,
    "error": "Transcript already requested [error-transcript-already-requested]",
    "errorType": "error-transcript-already-requested"
}

{% endtab %} {% endtabs %}

Change Log

Version	Description
6.4.0	Added