AI Actions

O que são as AI Actions?

As AI Actions são ações que o seu chatbot pode FAZER durante uma conversa - e não apenas dizer. Uma ação pode apresentar um formulário de contacto, pesquisar o seu catálogo de produtos, verificar uma encomenda, iniciar um Live Chat ou chamar a sua própria API. No caso das ações orientadas por IA, o modelo decide quando solicitar a ação com base nas suas instruções e na conversa. As ações designadas como "após X mensagens" utilizam, em alternativa, um acionador baseado na contagem de mensagens. Ativar uma ação não garante que esta seja executada em todas as perguntas correspondentes.

Recorra às AI Actions quando pretender automatizar o que acontece no chat para além de responder a perguntas - por exemplo, recolher um lead quando um visitante demonstra interesse de compra, ou transferir o atendimento para um operador humano quando o bot não consegue ajudar.

Se ainda não tem um bot, crie o seu primeiro chatbot. Configure a funcionalidade relevante de recolha de leads, formulário de contacto humano ou Live Chat antes de ativar a respetiva ação.

Onde encontrar as AI Actions

Selecione o seu chatbot e navegue até Settings > Actions (Definições > Ações).

Compreender os blocos de ação

Cada ação é apresentada sob a forma de um bloco que mostra o seu nome, uma breve descrição e o seu estado atual. As ações surgem em três estados:

• Active (Ativo - distintivo verde) - A ação está ativada e o chatbot pode utilizá-la durante as conversas. As ações ativas apresentam um botão Edit (Editar - lápis) e um botão Remove (Remover - X).

• Inactive (Inativo - distintivo cinzento) - A ação está disponível, mas não está atualmente ativada. Clique no ícone de adição (+) Add (Adicionar) no bloco para a ativar.

• Not connected (Não ligado - bloco desativado a cinzento) - A ação necessita de um elemento que ainda não está configurado, como uma integração associada ou um plano que inclua a funcionalidade. Passe o cursor sobre o bloco para ver exatamente o que é necessário e clique no botão Connect/Setup (Ligar/Configurar - ficha) para ir para a página onde o elemento em falta é configurado - no caso de plataformas de e-commerce e de gestão empresarial, trata-se do separador Connect (Ligar).

Filtrar por plataforma

A barra lateral Filter by Platform (Filtrar por plataforma) à direita permite filtrar a lista de ações para uma plataforma ou categoria específica. Os filtros disponíveis dependem das suas integrações e funcionalidades. Os exemplos incluem:

• AI Search, Hospitality e XML Feed - Ações de pesquisa de produtos e quartos, onde estiverem configuradas
• Formulários personalizados - Ações que apresentam os seus formulários
• APIs personalizadas - Ações das suas integrações de API personalizadas
• Apoio humano - Acionadores de formulários de contacto humano
• Recolha de leads - Ações de captura de leads
• Live Chat - Acionadores de escalamento para chat em direto
• Plataformas de e-commerce - Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart, Wix, Abicart (o Wix disponibiliza apenas o estado da encomenda, não a pesquisa de produtos)
• Plataformas empresariais - BaseLinker (apenas estado da encomenda), Beds24, Freshdesk, Hostfully, Hotres, IdoBooking, KWHotel, Mews, NFHotel, Previo, THTG

Clique em Show All (Mostrar tudo) para apresentar todas as ações.

---

Ativar e configurar uma ação

Passo 1: ativar a ação

Encontre a ação que pretende utilizar e clique no ícone de adição (+) Add (Adicionar) no respetivo bloco. Abre-se uma caixa de diálogo de configuração.

Passo 2: configurar a ação

A caixa de diálogo de configuração contém várias secções, consoante o tipo de ação.

When to use this action (Quando utilizar esta ação) - Descreve as circunstâncias em que a IA deve acionar esta ação. As ações pré-configuradas incluem predefinições adequadas. Para ações personalizadas, escreva instruções claras que expliquem os cenários de conversa que devem ativar a ação.

Exemplo:

Use this action when the customer asks about product availability, pricing, or specifications. Trigger phrases include "do you have...", "how much is...", or "tell me about a product".

Display action label (Apresentar etiqueta da ação) - Um interruptor que controla se é apresentada uma mensagem de estado no chat enquanto a ação é executada. Quando ativado, introduza uma etiqueta curta, como "A pesquisar produtos..." ou "A verificar disponibilidade...", que o visitante vê durante a execução.

Advanced Settings (Definições avançadas - secção expansível):

• AI Action Definition (Definição da ação de IA) - Define o comportamento técnico da ação. As ações pré-configuradas têm esta opção configurada automaticamente. Para ações de API personalizadas, descreva o objetivo da função e mencione os parâmetros que o chatbot necessita de recolher a partir da conversa. Não inclua detalhes de integração, como URLs ou métodos HTTP - descreva apenas o que a função faz e quais os parâmetros de que necessita.

• AI Action internal name (Nome interno da ação de IA) - Um identificador de apenas leitura utilizado internamente pelo modelo de IA. Útil para referenciar em instruções de acionamento (por exemplo, "Use the getProductDetails action when...").

Clique em Enable (Ativar - para novas ativações) ou em Update (Atualizar - para edições) para guardar as suas alterações.

---

Categorias de ações pré-configuradas

Suporte humano

• AI Driven human contact form - Apresenta automaticamente o formulário de contacto com o suporte humano quando a IA deteta que o visitante precisa de ajuda humana
• Human contact form after X messages - Mostra o formulário de contacto após um número definido de mensagens

Recolha de leads

• Lead collection after X messages - Apresenta o formulário de recolha de leads após um número definido de mensagens
• AI driven lead collection - A IA escolhe o melhor momento para pedir dados de contacto
• Smart AI lead detection - Deteta discretamente dados de lead a partir do texto da conversa

Live Chat

• AI triggered live chat - Solicita uma transferência quando a IA determina que o visitante precisa de ajuda em tempo real. O Live Chat tem de estar configurado e disponível; um operador ainda precisa de entrar.

Integrações de e-commerce

Ações de pesquisa de produtos e estado de encomendas para Shopify, WooCommerce, PrestaShop, Shoper, CS-Cart e Abicart. O Wix disponibiliza apenas o estado de encomendas. Estas ações requerem que a integração correspondente seja ligada primeiro (Connect [Ligar]).

Integrações de plataformas de negócio

Ações para BaseLinker, Beds24, Freshdesk, Hostfully, Hotres, IdoBooking, KWHotel, NFHotel, Previo e THTG. Estas incluem detalhes de encomendas, gestão de pedidos de suporte, pesquisa de quartos e apartamentos, verificações de disponibilidade e consultas de reservas.

---

Ações de API personalizadas

Pode criar as suas próprias ações que comunicam com APIs externas.

1. Aceda a Custom Integrations (Integrações personalizadas) no menu principal para definir o seu endpoint de API, método HTTP, cabeçalhos e parâmetros (consulte Integrações de API personalizadas para obter um guia passo a passo completo)

2. Regresse a Settings > Actions no seu bot - as suas ações de API personalizadas surgem na lista de ações sob o filtro Custom APIs

3. Ative-as e configure-as da mesma forma que as ações pré-configuradas

Ao escrever a AI Action Definition para ações personalizadas, concentre-se em descrever o que a função faz e quais os parâmetros que o chatbot deve recolher da conversa. Não repita detalhes de integração (URL, cabeçalhos, autenticação) que já se encontram configurados na página Custom Integrations.

---

Ações de formulários personalizados e limites de ações

Para apresentar um formulário durante uma conversa, crie-o primeiro em Settings > Forms (Definições > Formulários) e, em seguida, utilize Add action for custom form (Adicionar ação para formulário personalizado) em Settings > Actions. Escolha o formulário e descreva quando este deve surgir. Consulte Formulários personalizados para a configuração completa.

Algumas caixas de diálogo de ações também incluem definições de segurança e privacidade. Onde disponível, o Rate limiting (Limitação de taxa) restringe as tentativas por conversa ou por janela temporal do visitante; o Personal data masking (Mascaramento de dados pessoais) mascara os campos pessoais suportados nos resultados da ação antes de a IA os receber. A disponibilidade e as predefinições dependem da ação. Estas opções não substituem a autorização na sua API associada.

Boas práticas

• Seja específico nas instruções de acionamento - Descreva claramente o cenário exato e inclua exemplos de frases do utilizador
• Evite a sobreposição de acionadores - Certifique-se de que diferentes ações têm condições de acionamento distintas, para que a IA selecione a correta
• Mantenha as etiquetas de ação curtas - Utilize formas contínuas ("A pesquisar produtos...", "A verificar estado da encomenda...") e mantenha o texto com menos de 50 carateres
• Ative apenas o que necessita - Ter demasiadas ações ativas pode confundir a IA relativamente a qual deve utilizar
• Teste no Overview (Visão geral) - Inicie uma nova conversa de teste, solicite a ação utilizando uma linguagem realista, forneça os dados necessários e verifique tanto a resposta do bot como o resultado no sistema integrado. Os testes podem executar operações reais na API.
• Utilize o Reset instructions (Repor instruções) - Se o seu prompt personalizado não estiver a funcionar bem, clique em Reset instructions para restaurar a predefinição e começar de novo

Artigos relacionados

• Integrações de API personalizadas
• Recolha de leads
• Live Chat
• Formulário de contacto com o suporte humano