Conexão do Slack ao criador de ações
Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.
- Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
- Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
- Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.
- Na Central de administração, clique em
Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação. - Crie ou edite um fluxo de ação.
- Abra a barra lateral da etapa.
- Em Ações externas, clique em Slack.
- Clique em Conectar.
- use o Slack para autenticar a conta.
Para concluir a autenticação, você deve convidar o aplicativo conector do Zendesk:
/invite @Zendesk Connector.Observação: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
Depois de se conectar ao sistema, você verá um indicador de conexão e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para o Slack.
Uso de ações do Slack em fluxos de ação
As etapas de ação do Slack podem ser usadas em fluxos de ação para otimizar a comunicação e garantir que os usuários saibam sobre outras atividades que estão sendo executadas pelos fluxos de ação. Por exemplo, você pode enviar mensagens para canais e usuários individuais alertando-os sobre novos tickets ou atribuições de problemas no Jira, publicar resumos de tickets gerados por IA em uma conversa do Slack, transferir mensagens diretas para canais públicos para maior visibilidade, adicionar reações para reconhecer mensagens automaticamente ou extrair detalhes de mensagens para análise e responder com conteúdo gerado por IA.
Publicação de uma mensagem em um canal
Use a ação Publicar mensagem no canal para enviar uma mensagem a um canal público ou privado.
As entradas e saídas dessa ação são:
| Variáveis | |
|---|---|
| Entradas |
channel, message
|
| Saída |
channel, ts, ok
|
Envio de uma mensagem direta
Use a ação Enviar mensagem direta para enviar uma mensagem direta a um usuário específico.
| Variáveis | |
|---|---|
| Entradas |
email, message
|
| Saída | Dados completos da mensagem |
Resposta a uma mensagem em uma conversa
Use a ação Responder à conversa por mensagem para publicar uma resposta a uma mensagem em uma conversa. Esta etapa pode criar uma conversa ou uma resposta dentro de uma conversa existente.
As entradas e saídas dessa ação são:
| Variáveis | |
|---|---|
| Entradas |
email, message
|
| Saída | Valor não especificado |
Obtenção de todas as mensagens em uma conversa
Use a ação Obter mensagens da conversa para recuperar todas as mensagens em uma conversa.
As entradas e saídas dessa ação são:
| Variáveis | |
|---|---|
| Entradas |
channel, thread_ts, reply_ts
|
| Saída | messages |
Adição de uma reação a uma mensagem
Use a ação Adicionar reação para adicionar uma reação de emoji a uma mensagem.
As entradas e saídas dessa ação são:
| Variáveis | |
|---|---|
| Entradas |
channel, name, timestamp
|
| Saída | success |
Obtenção de uma mensagem
Use a ação Obter mensagem para recuperar o conteúdo e metadados de uma mensagem.
As entradas e saídas dessa ação são:
| Variáveis | |
|---|---|
| Entradas |
channel, timestamp
|
| Saída |
text, user
|
Localização de usuário
Use a ação Encontrar usuário para recuperar um usuário do Slack de modo que seja possível fazer referência a ele posteriormente no fluxo de ação.
As entradas e saídas dessa ação são:
| Variáveis | |
|---|---|
| Entradas | user_id |
| Saída |
display_name, email, real_name, user_id
|
Receita: notificação de agentes sobre tickets recém-atribuídos no Slack
O exemplo de fluxo de ação a seguir envia automaticamente notificações a agentes no Slack quando um ticket do Zendesk é atribuído a eles. Esse tipo de notificação pode reduzir o tempo de reação e impedir que os tickets passem despercebidos.
- Adicionar um gatilho de fluxo de ação com estes detalhes:
- Clique em Adicionar gatilho.
- Na barra lateral da etapa, em Zendesk, clique em Tickets.
- Clique em Encaminhamento e selecione Atribuição de agente do ticket alterada.
- Adicionar uma etapa para procurar detalhes do ticket:
- No criador de ações, abaixo do gatilho do fluxo de ação, clique no ícone Adicionar etapa (
). - Na barra lateral da etapa, em Ações do Zendesk, clique em Procurar ticket.
- Em ID do ticket, clique dentro do campo e depois em Selecione uma variável.
- No menu de variáveis, selecione 1 Atribuição de agente do ticket alterada como a etapa geradora da variável que você quer usar e depois selecione ID do ticket.
- No criador de ações, abaixo do gatilho do fluxo de ação, clique no ícone Adicionar etapa (
- Adicionar uma etapa para procurar detalhes do usuário sobre o atribuído para o ticket:
- No criador de ações, clique no ícone Adicionar etapa (
). - Na barra lateral da etapa, em Ações do Zendesk, clique em Pesquisar usuário.
- Em Tipo de ID do usuário, selecione ID do usuário do Zendesk.
- Para ID do usuário, clique em Adicionar variável.
- No menu de variáveis, selecione 2 Procurar ticket como a etapa geradora da variável que você quer usar e depois selecione ID do atribuído.
- No criador de ações, clique no ícone Adicionar etapa (
- Adicionar uma etapa para procurar detalhes do usuário sobre o solicitante do ticket:
- No criador de ações, clique no ícone Adicionar etapa (
). - Na barra lateral da etapa, em Ações do Zendesk, clique em Pesquisar usuário.
- Em Tipo de ID do usuário, selecione ID do usuário do Zendesk.
- Para ID do usuário, clique em Adicionar variável.
- No menu de variáveis, selecione 2 Procurar ticket como a etapa geradora da variável que você quer usar e depois selecione ID do solicitante.
- No criador de ações, clique no ícone Adicionar etapa (
- Adicionar uma etapa para procurar detalhes da organização do solicitante do ticket:
- No criador de ações, clique no ícone Adicionar etapa (
). - Na barra lateral da etapa, em Ações do Zendesk, clique em Pesquisar organização.
- Em Tipo de ID da organização, selecione ID da organização do Zendesk.
- Para ID da organização, clique em Adicionar variável.
- No menu de variáveis, selecione 4 Pesquisar usuário como a etapa geradora da variável que você quer usar e depois selecione ID da organização.
- No criador de ações, clique no ícone Adicionar etapa (
- Adicione uma etapa que envia uma mensagem direta no Slack ao atribuído do ticket que contém as informações que você coletou para o ticket, o atribuído e a organização:
- No criador de ações, clique no ícone Adicionar etapa (
). - Na barra lateral da etapa, em Ações externas, clique em Slack e selecione Publicar mensagem direta.
- Em E-mail, clique em Adicionar variável.
- No menu de variáveis, selecione 3 Pesquisar usuário como a etapa geradora da variável e depois selecione E-mail.
- Em Mensagem, insira a mensagem que você deseja enviar ao agente recém-atribuído. Inclua informações relevantes de ticket, solicitante e organização como variáveis das etapas Procurar ticket e Pesquisar usuário, respectivamente, para simplificar a capacidade de resolver o ticket. No exemplo abaixo, todas as variáveis estão em itálico:
Hi Assignee > Name, Ticket Ticket ID has been assigned to you. Please respond as soon as possible. User contact information: - Email: Requester > Email - Locale and timezone: Requester > Locale - Requester > IANA timezone - Notes: Requester > Notes Here's more context on the ticket: - Ticket subject: Ticket Subject - Ticket description: Ticket Description - Last ticket update: Ticket's Latest agent update
- No criador de ações, clique no ícone Adicionar etapa (
- Clique em Salvar.
- Clique em Testar para testar o fluxo de ação.
- Clique no menu de opções (
) e selecione Ativar para começar a usar o fluxo de ação para notificar automaticamente os agentes no Slack de que um ticket do Zendesk foi atribuído a eles.