Resumo
O fluxo de ação Criar ajuda você a transformar modelos pré-construídos em ações totalmente configuradas que seus agentes podem usar. Você pode selecionar um modelo, definir sua finalidade, conectar contas necessárias e configurar as configurações - tudo em um fluxo guiado. Uma vez criada, a ação aparece em Minhas ações e pode ser anexada aos agentes.
Instruções
Como criar uma ação
Siga estas etapas para criar uma nova ação a partir de um modelo:
1. Faça login na sua conta Astra
Faça login na sua conta Astra
2. Abra a biblioteca de ações
Vá para a Biblioteca de ações
Navegue pelos modelos usando:
Todos
Recentes
Por tipo
Clique em um modelo para iniciar o fluxo de criação
3. Autorize (se necessário)
Algumas ações (por exemplo, CRM como Hubspot ou Planilhas Google ou APIs) exigem autorização de conta
Se necessário, um pop-up aparecerá
Siga as etapas na tela para autorizar sua conta
Uma vez concluído, você continuará para a próxima etapa.
4. Defina os detalhes da ação (página de intenção)
Na página de intenção, preencha os detalhes necessários:
Nome: Um nome claro para a ação
Intenção: Descreva o que a ação deve fazer
Campos adicionais (dependendo do modelo)
Dica: Seja específico e descritivo. Uma intenção bem definida ajuda o agente a usar a ação com mais precisão.
Depois de preencher os detalhes:
Clique em Confirmar para prosseguir
Você será levado para a página de configuração
Clique em Editar intenção da ação a qualquer momento para voltar e fazer alterações
5. Configure a ação
Preencha todas as configurações necessárias com base no modelo selecionado
Isso pode incluir entradas de API, conteúdo da mensagem ou mapeamentos de campo
6. Salve a ação
Clique em Salvar como rascunho para salvar o progresso sem tornar a ação disponível
Clique em Salvar ação para publicá-la como uma ação ativa
Estados da ação:
Rascunho:
Salvo, mas não disponível para agentes
Útil para testes ou configuração incompleta
Ativa:
Totalmente configurado e disponível para uso
Pode ser anexado aos agentes
Depois de criar uma ação
A ação aparecerá em Minhas ações na Biblioteca de ações
Para usá-la, anexe a ação a um agente
Criar ações na página do agente
Você também pode criar ações ao configurar um agente:
Faça login na sua conta Astra
Vá para a página Agentes, selecione qualquer agente (ou crie um novo) e vá para Construir meu agente
Clique em Adicionar ação
A Biblioteca de ações será aberta em um pop-up
Selecione um modelo e siga as mesmas etapas para criar a ação
Como atualizar uma ação
Atualizar ação permite que você modifique o nome, a intenção, o status, a conta conectada ou qualquer configuração específica do modelo de uma ação existente.
Você só pode editar ações que você criou ou que existem em seu espaço de trabalho.
O fluxo de atualização usa as mesmas páginas de intenção e configuração do fluxo de criação - a única diferença é que você começa de uma ação existente em vez de um modelo.
Para editar qualquer ação, siga estas etapas:
Faça login na sua conta Astra
Vá para a Biblioteca de ações
Abra a guia Minhas ações
Escolha a ação que deseja atualizar:
Clique diretamente no cartão de ação ou
Clique nos três pontos (⋮) e selecione Editar
Atualize os campos obrigatórios:
Página de intenção: edite o nome, a intenção ou outros detalhes gerais
Página de configuração: atualize as configurações específicas do modelo
Se necessário, clique em Editar intenção da ação para retornar à página de intenção
Clique em Salvar depois de fazer suas alterações
Após atualizar uma ação
Quaisquer alterações são aplicadas imediatamente
Se a ação já estiver anexada a agentes ativos, a versão atualizada será usada automaticamente
Observação: Tenha cuidado ao atualizar ações que estão em uso, pois as alterações podem impactar diretamente o comportamento do agente ao vivo.
Como excluir uma ação
Excluir ação permite que você remova permanentemente uma ação que não precisa mais.
Uma vez excluída, a ação é removida de Minhas ações e não estará mais disponível para uso em agentes ou integrações.
Excluir uma ação não afeta nenhuma conta conectada que foi configurada dentro dela.
Para excluir uma ação, siga estas etapas:
Vá para a Biblioteca de ações
Abra a guia Minhas ações
Encontre a ação que deseja excluir
Clique nos três pontos (⋮) no cartão de ação
Selecione Excluir
Importante
Se a ação estiver sendo usada por algum agente (em modo de teste ou publicado), você não pode excluí-la
Você deve primeiro remover a ação de todos os agentes associados antes de excluí-la
Se a ação não estiver em uso, você pode prosseguir com a exclusão
Após excluir uma ação
A ação é removida permanentemente de Minhas ações
Não estará mais disponível para anexar a nenhum agente
Como funcionam a autenticação e as contas
Algumas ações (como Pesquisa na Web ou Formulários personalizados) podem ser usadas sem qualquer autenticação.
Para a maioria das plataformas de terceiros (como Slack, Planilhas Google e HubSpot), a Astra usa OAuth 2.0 (Open Authorization) para autenticação segura.
Quando você cria uma ação que requer autenticação, um pop-up aparecerá solicitando que você conecte sua conta
Clique em Conectar sua conta (por exemplo, espaço de trabalho do Slack ou conta do HubSpot).
Uma nova guia do navegador será aberta
Siga as etapas específicas da plataforma para concluir a autenticação
Cada plataforma pode ter um fluxo ligeiramente diferente, e guias detalhados estão disponíveis onde necessário
Gerenciando contas conectadas
Na página de configuração da ação, se a autenticação for necessária, você verá uma opção de seleção de conta onde você pode:
Trocar de conta
Adicionar uma nova conta
Desconectar uma conta existente
Adicionar uma nova conta
Clique em Adicionar conta
Conclua o mesmo fluxo de autenticação de antes para conectar outra conta
Desconectar uma conta
Clique em Desconectar para remover uma conta conectada
Uma verificação de segurança será aplicada:
Se a conta ainda estiver sendo usada por alguma ação ativa (não excluída), você não pode desconectá-la
Você deve primeiro atualizar essas ações para usar uma conta diferente ou remover as ações
Se a conta não for usada por nenhuma ação ativa, ela poderá ser desconectada com segurança
Outros métodos de autenticação
Algumas ações (como Wati ou ações da API REST) usam métodos não OAuth para autenticação
Nesses casos, siga as instruções na tela para concluir a configuração
Guias específicos da plataforma estão disponíveis para etapas detalhadas
Conclusão
As ações são os blocos de construção que permitem que seus agentes Astra executem tarefas reais além das conversas. Ao criar, atualizar e gerenciar ações de forma eficaz, você pode automatizar fluxos de trabalho, integrar-se a ferramentas externas e melhorar a forma como seus agentes respondem às necessidades dos clientes.
À medida que você escala, mantenha suas ações bem definidas, revise e atualize-as regularmente e garanta que as conexões sejam gerenciadas corretamente. Isso ajuda a manter a precisão, evitar interrupções e obter o máximo valor de sua configuração de automação.