Send reply
Reply to the customer of a conversation and set its status.
POST https://cotlet.dev/api/v1/help-scout/conversations/{conversation_id}/replies
write Confirm
Sends a reply from your account, as the Reply editor does, and the customer gets it by email. Status sets the conversation state when the reply goes out (active, pending or closed); without it Help Scout applies the inbox default. assign_to hands the conversation to a teammate at the same moment, and cc and bcc add recipients. Returns the new thread and the final status. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation number from search_conversations. |
| text string required | string | Reply body, plain text or simple HTML. |
| status enum | enum | active, pending or closed. Default: the inbox default. |
| assign_to string | string | Teammate's name or email. Light Users cannot be assigned conversations. |
| cc array | array | Email addresses to copy. |
| bcc array | array | Email addresses to blind copy. |
Request
curl -X POST https://cotlet.dev/api/v1/help-scout/conversations/48213/replies \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Hi Lena, you can add a teammate under Manage > Users. Here is the step-by-step guide: https://docs.example.com/article/12-add-and-remove-users. Tell me if anything looks different on your side.","status":"pending"}'result = client.call("help-scout", "send_reply", {"conversation_id":48213,"text":"Hi Lena, you can add a teammate under Manage > Users. Here is the step-by-step guide: https://docs.example.com/article/12-add-and-remove-users. Tell me if anything looks different on your side.","status":"pending"})const result = await cotlet.call('help-scout', 'send_reply', {"conversation_id":48213,"text":"Hi Lena, you can add a teammate under Manage > Users. Here is the step-by-step guide: https://docs.example.com/article/12-add-and-remove-users. Tell me if anything looks different on your side.","status":"pending"});cotlet call help-scout send_reply --data '{"conversation_id":48213,"text":"Hi Lena, you can add a teammate under Manage > Users. Here is the step-by-step guide: https://docs.example.com/article/12-add-and-remove-users. Tell me if anything looks different on your side.","status":"pending"}'Example response
{
"conversation_id": 48213,
"thread_id": 903311,
"sent_to": "lena@example.com",
"status": "pending",
"assignee": null
}