Help Scout
Aynı zamanda bir ajan aracıHelp Scout Mailbox API 2.0: Conversations (list/get/create/update PATCH move-assign-status-subject/delete, threads list + create reply/note/customer/chat/phone, update thread, attachment data + delete, custom fields, tags), Customers (list/get/create/update + addresses, emails, phones, chat handles, social profiles, websites, properties), Mailboxes (list/get/fields/folders), Users (list/get/me/teams), Teams (list/get/members), Tags, Workflows (list, run manual), Webhooks (CRUD), and Reports (conversations, productivity, company, email, chat, phone, docs, happiness). Base URL is static https://api.helpscout.net/v2. Auth is OAuth2 client_credentials — the runtime mints a Bearer token from https://api.helpscout.net/v2/oauth2/token (grant_type=client_credentials) using the app's client_id + client_secret. List Conversations is the polling trigger: modifiedSince timestamp cursor + page pagination over the HAL _embedded.conversations envelope. Help Scout signs webhook deliveries as base64(HMAC-SHA1(raw_body, secret)) in the X-HelpScout-Signature header with the event name in X-HelpScout-Event — this matches the generic_hmac handler (sha1/base64/raw_body), so change notifications are delivered as webhook triggers; webhook CRUD is also exposed as actions.
66 eylemler · 14 tetikleyiciler
Help Scout entegrasyonu — 66 aksiyon ve 14 tetikleyici ile Help Scout'ı otomasyonlarına bağla; her aksiyon aynı zamanda bir AI agent aracı. Örnek: Get Current User, List Conversations, Get Conversation, Create Conversation, Update Conversation. Boş bir tuvalde uğraşmadan — bağla ve workflow'larında kullan.
Aşağıdaki her eylem, bir AI ajanının da çağırabileceği bir araçtır — aynı pack hem iş akışlarınızı hem ajanlarınızı çalıştırır.
Tetikleyiciler 14
Help Scout üzerinde bir iş akışını başlatabilen olaylar.
Conversation Created
Fires when a conversation is created (Help Scout event convo.created). Discriminated by the X-HelpScout-Event header. Payload is the full conversation object.
Conversation Assigned
Fires when a conversation is assigned (event convo.assigned).
Conversation Status Changed
Fires when a conversation's status changes (event convo.status).
Conversation Moved
Fires when a conversation is moved to another mailbox (event convo.moved).
Conversation Merged
Fires when a conversation is merged into another (event convo.merged).
Conversation Deleted
Fires when a conversation is deleted (event convo.deleted).
Conversation Tags Updated
Fires when a conversation's tags change (event convo.tags).
Agent Reply Created
Fires when an agent replies to a conversation (event convo.agent.reply.created).
Customer Reply Created
Fires when a customer replies to a conversation (event convo.customer.reply.created).
Note Created
Fires when an internal note is added to a conversation (event convo.note.created).
Customer Created
Fires when a customer is created (event customer.created). Payload is the full customer object.
Customer Updated
Fires when a customer is updated (event customer.updated).
Satisfaction Rating
Fires when a customer submits a satisfaction rating (event satisfaction.ratings).
New or updated Help Scout conversations (polled)
Polls GET /v2/conversations with a modifiedSince watermark on a schedule; results are in the HAL _embedded.conversations envelope, paged via page / _links.next.
Eylemler 66
Zervanor'un Help Scout üzerinde yapabilecekleri.
Customers23
List Customers
List customers (GET /v2/customers). HAL _embedded.customers envelope with page pagination; supports mailbox, firstName, lastName, modifiedSince, email, query filters.
Get Customer
Get a single customer by id (GET /v2/customers/{customerId}).
Create Customer
Create a customer (POST /v2/customers).
Update Customer
Update a customer's core fields (PUT /v2/customers/{customerId}).
List Customer Address
Get a customer's address (GET /v2/customers/{customerId}/address).
Create Customer Address
Create a customer's address (POST /v2/customers/{customerId}/address).
Update Customer Address
Update a customer's address (PUT /v2/customers/{customerId}/address).
Create Customer Email
Add an email to a customer (POST /v2/customers/{customerId}/emails).
Update Customer Email
Update a customer's email (PUT /v2/customers/{customerId}/emails/{emailId}).
Delete Customer Email
Delete a customer's email (DELETE /v2/customers/{customerId}/emails/{emailId}).
Create Customer Phone
Add a phone to a customer (POST /v2/customers/{customerId}/phones).
Update Customer Phone
Update a customer's phone (PUT /v2/customers/{customerId}/phones/{phoneId}).
Delete Customer Phone
Delete a customer's phone (DELETE /v2/customers/{customerId}/phones/{phoneId}).
Create Customer Chat Handle
Add a chat handle to a customer (POST /v2/customers/{customerId}/chats).
Update Customer Chat Handle
Update a customer's chat handle (PUT /v2/customers/{customerId}/chats/{chatId}).
Delete Customer Chat Handle
Delete a customer's chat handle (DELETE /v2/customers/{customerId}/chats/{chatId}).
Create Customer Social Profile
Add a social profile to a customer (POST /v2/customers/{customerId}/social-profiles).
Update Customer Social Profile
Update a customer's social profile (PUT /v2/customers/{customerId}/social-profiles/{socialProfileId}).
Delete Customer Social Profile
Delete a customer's social profile (DELETE /v2/customers/{customerId}/social-profiles/{socialProfileId}).
Create Customer Website
Add a website to a customer (POST /v2/customers/{customerId}/websites).
Update Customer Website
Update a customer's website (PUT /v2/customers/{customerId}/websites/{websiteId}).
Delete Customer Website
Delete a customer's website (DELETE /v2/customers/{customerId}/websites/{websiteId}).
Update Customer Properties
Update a customer's property values via JSON Patch (PATCH /v2/customers/{customerId}/properties).
Conversations17
List Conversations
List conversations (GET /v2/conversations). Supports modifiedSince, status, tag, mailbox, folder filters, page pagination, and HAL _embedded.conversations + _links.next + page.totalPages. Used as the polling trigger.
Get Conversation
Get a single conversation by id (GET /v2/conversations/{conversationId}).
Create Conversation
Create a conversation (POST /v2/conversations). Requires subject, customer, mailboxId, type, status, and at least one thread.
Update Conversation
Update a conversation via JSON Patch (PATCH /v2/conversations/{conversationId}) — move mailbox/folder, assign, change status, change subject, etc. Body is a JSON Patch op { op, path, value }.
Delete Conversation
Delete a conversation (DELETE /v2/conversations/{conversationId}).
List Conversation Threads
List a conversation's threads (GET /v2/conversations/{conversationId}/threads). HAL _embedded.threads envelope.
Create Reply Thread
Add a reply thread to a conversation (POST /v2/conversations/{conversationId}/reply). A reply is sent to the customer.
Create Note Thread
Add an internal note to a conversation (POST /v2/conversations/{conversationId}/notes). Notes are not visible to customers.
Create Customer Thread
Add a customer thread to a conversation (POST /v2/conversations/{conversationId}/customer) — logs a message on behalf of the customer.
Create Chat Thread
Add a chat thread to a conversation (POST /v2/conversations/{conversationId}/chats).
Create Phone Thread
Add a phone thread to a conversation (POST /v2/conversations/{conversationId}/phones).
Update Thread
Update a thread's text (PATCH /v2/conversations/{conversationId}/threads/{threadId}). JSON Patch on /text.
Get Attachment Data
Get an attachment's binary data, base64-encoded (GET /v2/conversations/{conversationId}/attachments/{attachmentId}/data).
Delete Attachment
Delete an attachment (DELETE /v2/conversations/{conversationId}/attachments/{attachmentId}).
List Conversation Custom Fields
List a conversation's custom field values (GET /v2/conversations/{conversationId}/fields).
Update Conversation Custom Fields
Set a conversation's custom field values (PUT /v2/conversations/{conversationId}/fields).
Update Conversation Tags
Set a conversation's tags (PUT /v2/conversations/{conversationId}/tags). Replaces the full tag set.
Reports8
Conversations Report
Company conversations report (GET /v2/reports/conversations) — volume, busy times, new/replies for a date range.
Productivity Report
Productivity report (GET /v2/reports/productivity) — response/resolution/handle times over a date range.
Company Report
Company overview report (GET /v2/reports/company) — customers helped, conversations, happiness for a date range.
Email Channel Report
Email channel report (GET /v2/reports/email) — email conversation metrics for a date range.
Chat Channel Report
Chat channel report (GET /v2/reports/chat) — chat conversation metrics for a date range.
Phone Channel Report
Phone channel report (GET /v2/reports/phone) — phone conversation metrics for a date range.
Docs Report
Docs report (GET /v2/reports/docs) — knowledge-base article performance for a date range.
Happiness Report
Happiness (satisfaction ratings) report (GET /v2/reports/happiness) — great/okay/not-good ratings for a date range.
Webhooks5
List Webhooks
List webhooks (GET /v2/webhooks). HAL _embedded.webhooks envelope.
Get Webhook
Get a single webhook by id (GET /v2/webhooks/{webhookId}).
Create Webhook
Create a webhook subscription (POST /v2/webhooks). Provide the callback URL, subscribed events, and a secret used to sign deliveries.
Update Webhook
Update a webhook subscription (PUT /v2/webhooks/{webhookId}).
Delete Webhook
Delete a webhook subscription (DELETE /v2/webhooks/{webhookId}).
Mailboxes4
List Mailboxes
List mailboxes (GET /v2/mailboxes). HAL _embedded.mailboxes envelope.
Get Mailbox
Get a single mailbox by id (GET /v2/mailboxes/{mailboxId}).
List Mailbox Custom Fields
List a mailbox's custom field definitions (GET /v2/mailboxes/{mailboxId}/fields).
List Mailbox Folders
List a mailbox's folders (GET /v2/mailboxes/{mailboxId}/folders).
Teams3
List Teams
List teams (GET /v2/teams). HAL _embedded.teams envelope. Requires a Plus/Pro plan.
Get Team
Get a single team by id (GET /v2/teams/{teamId}).
List Team Members
List a team's members (GET /v2/teams/{teamId}/members).
Users3
Get Current User
Get the authenticated user (GET /v2/users/me). Identity + connectivity probe.
List Users
List users (GET /v2/users). HAL _embedded.users envelope; supports mailbox filter + page pagination.
Get User
Get a single user by id (GET /v2/users/{userId}).
Workflows2
List Workflows
List workflows (GET /v2/workflows). HAL _embedded.workflows envelope.
Run Manual Workflow
Run a manual workflow against a set of conversations (POST /v2/workflows/{workflowId}/run).
Tags1
List Tags
List tags (GET /v2/tags). HAL _embedded.tags envelope with page pagination.
Aramanızla eşleşen bir şey yok.
Help Scout kullanan Çözüm Şablonları
Help Scout ile kendi otomasyonunu görsel tasarımcıda kur.
Sıkça sorulan sorular
Help Scout ile neler otomatikleştirebilirim?
66 aksiyon var — örneğin: Get Current User, List Conversations, Get Conversation, Create Conversation, Update Conversation ve daha fazlası.
Hangi Help Scout olayları bir workflow başlatabilir?
14 tetikleyici — örneğin: Conversation Created, Conversation Assigned, Conversation Status Changed, Conversation Moved.
Help Scout bir AI agent aracı olarak kullanılabilir mi?
Evet. Help Scout'ın her aksiyonu otomatik olarak bir AI agent aracına dönüşür — aynı pack hem workflow'larını hem agent'larını besler.
Help Scout entegrasyonu nasıl modellenir?
Help Scout sürümlü bir connector pack olarak modellenir; muhakeme gerektiren adımlar workflow'larla aynı runtime'da barınan first-party agent'lara düşer.