Principal Recursos avançados explicados da Wootdesk.

Recursos avançados explicados da Wootdesk.

Explore recursos avançados como automação, regras de atribuição, atributos personalizados, macros, SLAs e webhooks.
Por WootDesk
9 artigos

Como usar formulários pré-chat?

O formulário pré-chat é utilizado para coletar informações do contato/conversa antes do início do atendimento. O formulário pré-chat está disponível apenas no chat ao vivo do site. Como adicionar um formulário pré-chat? Passo 1. Acesse Configurações → Inboxes e clique nas configurações específicas de um inbox do tipo Website. Passo 2. Abra a aba “Formulário Pré-Chat”. Existem dois tipos de campos disponíveis no formulário pré-chat: Campos padrão: E-mail, telefone e nome completo. Campos personalizados: Campos criados através de atributos personalizados. As configurações do formulário listarão tanto os campos padrão quanto os personalizados. Campos disponíveis nas configurações Chave (Key) Identificador único do campo. Tipo (Type) Tipo do campo: Texto Lista Número Data Link Booleano Obrigatório (Required) Define se o preenchimento do campo será obrigatório ou não. Rótulo (Label) Texto exibido ao visitante no widget. Placeholder Texto de exemplo exibido dentro do campo. O que você pode configurar? O administrador poderá: Ativar/desativar campos Alterar a ordem dos campos Editar rótulos e placeholders Ativar/desativar validações Personalize o formulário pré-chat conforme sua necessidade. Para adicionar novos campos, basta criar novos atributos personalizados. Como fica o formulário pré-chat? Após ativar o formulário pré-chat, os visitantes precisarão preencher um formulário semelhante ao abaixo antes de iniciar uma conversa no chat ao vivo. Também leia: Formulário pré-chat + Automações = 🚀

Última atualização em May 21, 2026

Como usar Campanhas?

O recurso de Campanhas permite enviar mensagens outbound para seus clientes. Existem dois tipos de campanhas no Wootdesk: I. Campanhas Contínuas (Ongoing Campaigns) As campanhas contínuas permitem enviar mensagens automáticas via chat do site com base em condições específicas, como: Tempo em uma página URL acessada Comportamento do visitante Essas campanhas ajudam a aumentar conversões e iniciar conversas com visitantes automaticamente. II. Campanhas Únicas (One-off Campaigns) As campanhas únicas permitem enviar campanhas de SMS para grupos de contatos específicos. Elas são ideais para: Promoções Avisos Atualizações importantes Campanhas de marketing Ofertas especiais Como criar uma Campanha Contínua? Passo 1. No menu lateral, clique em Campanhas. Selecione: Contínuas → Criar campanha contínua Passo 2. Será exibido um formulário para configurar a campanha. Campos disponíveis Título Nome interno da campanha. Mensagem Mensagem que será enviada automaticamente ao visitante. Selecionar Inbox Escolha o inbox do tipo Website onde a campanha será utilizada. Enviado por Defina se a mensagem será enviada por: Bot Agente URL Informe a URL onde a campanha deverá ser ativada. Você também pode utilizar URLs com wildcard para subdomínios ou subdiretórios. Tempo na página (segundos) Define quanto tempo o visitante deve permanecer na página antes da campanha ser disparada. Ativar campanha Define se a campanha ficará ativa ou não. Passo 3. Teste a campanha acessando a URL configurada e aguardando o tempo definido. Como criar uma Campanha Única? Passo 1. No menu lateral, clique em: Campanhas → Única → Criar campanha única Passo 2. Preencha os dados da campanha. Campos disponíveis Título Nome interno da campanha. Mensagem Mensagem SMS que será enviada aos clientes. Selecionar Inbox Escolha seu inbox SMS. Público Defina o grupo de contatos utilizando labels. Agendamento Escolha a data e horário de execução da campanha. Após preencher tudo, clique em Criar. A campanha aparecerá na lista de campanhas únicas. Como editar ou excluir campanhas? Acesse: Campanhas → Selecione o tipo da campanha Na listagem de campanhas, utilize as opções de: Editar Excluir para gerenciar suas campanhas existentes.

Última atualização em May 21, 2026

Como criar mensagens interativas?

O Wootdesk permite criar mensagens interativas como: Seleções de opções Formulários Cards Artigos diretamente no widget de chat do site utilizando as APIs. Essas mensagens podem ser criadas através da API de Nova Mensagem (New Message API). Exemplos de Payloads Utilize os exemplos abaixo como base para criar diferentes tipos de mensagens interativas. 1. Mensagem com opções Permite que o usuário selecione uma opção da lista. { "content": "Selecione uma das opções abaixo", "content_type": "input_select", "content_attributes": { "items": [ { "title": "Opção 1", "value": "Opcao 1" }, { "title": "Opção 2", "value": "Opcao 2" } ] }, "private": false } 2. Formulário Permite coletar dados do usuário diretamente no chat. { "content": "formulario", "content_type": "form", "content_attributes": { "items": [ { "name": "email", "placeholder": "Digite seu e-mail", "type": "email", "label": "E-mail", "default": "[email protected]" }, { "name": "mensagem", "placeholder": "Digite sua mensagem", "type": "text_area", "label": "Mensagem", "default": "Texto de exemplo" }, { "name": "nome", "placeholder": "Digite seu nome", "type": "text", "label": "Nome", "default": "João" }, { "name": "produto", "label": "Selecione um produto", "type": "select", "options": [ { "label": "🌯 Burrito", "value": "Burrito" }, { "label": "🍝 Pasta", "value": "Pasta" } ] } ] }, "private": false } 3. Cards Permite criar cards com imagem, descrição e botões de ação. { "content": "mensagem card", "content_type": "cards", "content_attributes": { "items": [ { "media_url": "https://example.com/produto.jpg", "title": "Tênis Nike 2.0", "description": "Tênis ideal para corrida", "actions": [ { "type": "link", "text": "Ver mais", "uri": "https://google.com" }, { "type": "postback", "text": "Adicionar ao carrinho", "payload": "ITEM_SELECTED" } ] } ] }, "private": false } 4. Artigos Permite enviar artigos e conteúdos úteis diretamente no chat. { "content": "artigos", "content_type": "article", "content_attributes": { "items": [ { "title": "Guia inicial da API", "description": "Documentação introdutória da API", "link": "https://google.com" }, { "title": "Documentação para desenvolvedores", "description": "Guias e boas práticas de desenvolvimento", "link": "https://google.com" } ] }, "private": false } Tipos de mensagens suportadas Tipo Descrição input_select Lista de opções form Formulários interativos cards Cards com mídia e ações article Lista de artigos/conteúdo Observações importantes As mensagens interativas funcionam no widget do site. Os payloads devem ser enviados utilizando a API de mensagens do Wootdesk. Você pode combinar essas mensagens com bots, automações e APIs externas para criar fluxos avançados de atendimento.

Última atualização em May 21, 2026

Como usar Automações?

O recurso de automação do Wootdesk ajuda sua equipe a automatizar tarefas repetitivas e otimizar o fluxo de atendimento. Com automações, você pode: Atribuir conversas automaticamente Adicionar labels Direcionar atendimentos para equipes específicas Encaminhar tickets para o agente ideal Enviar mensagens automáticas Acionar webhooks Resolver ou silenciar conversas automaticamente Tudo isso reduz tarefas manuais e aumenta a produtividade da equipe. Como funciona uma automação? Uma regra de automação é composta por 3 partes: Evento (Event) É o gatilho que inicia a automação. Condições (Conditions) São os critérios que precisam ser atendidos para a automação acontecer. Ações (Actions) São as tarefas executadas quando as condições são atendidas. Eventos de automação O Wootdesk possui atualmente 4 tipos de eventos: Conversa criada Disparado quando uma nova conversa é criada em qualquer canal. Conversa atualizada Disparado quando uma conversa recebe alguma atualização. Mensagem criada Disparado quando uma nova mensagem é enviada em uma conversa. Conversa reaberta Disparado quando uma conversa resolvida, pendente ou pausada é reaberta. Condições de automação As condições definem quando a automação será executada. As condições variam conforme o evento selecionado. Você pode utilizar operadores como: Igual a Diferente de Contém Não contém Presente Não presente Também é possível combinar condições utilizando: AND OR Ações disponíveis O Wootdesk suporta as seguintes ações automáticas: Atribuir para um agente Atribuir uma equipe Adicionar label Enviar e-mail para equipe Enviar transcrição da conversa Silenciar conversa Pausar conversa Resolver conversa Enviar webhook Cancelar automação Enviar anexo Enviar mensagem Essas ações podem ser usadas em qualquer regra de automação. Como criar uma regra de automação? Passo 1. Acesse: Configurações → Automação Clique em: Adicionar regra de automação Passo 2. Preencha os campos da automação. Nome Defina um nome para identificar a automação. Descrição Campo opcional para descrever o funcionamento da regra. Evento Selecione o gatilho da automação. Condições Defina os critérios necessários. Ações Escolha o que será executado automaticamente. Você pode adicionar múltiplas condições e ações. Exemplo prático Objetivo: Atribuir automaticamente todas as novas conversas em francês para a equipe comercial da França. Configuração Evento Conversa criada Condições Status da conversa = Aberta Idioma do navegador = Francês (fr) Ação Atribuir equipe → France Sales Como pausar, editar, duplicar ou excluir automações? Acesse: Configurações → Automação Na lista de automações, você encontrará ações rápidas: Pausar automação Desative o botão da coluna “Ativo”. Editar automação Clique no ícone de lápis. Duplicar automação Clique no ícone de cópia. Excluir automação Clique no ícone de X vermelho.

Última atualização em May 21, 2026

Como configurar conexão WebSocket?

O WebSocket estabelece uma conexão contínua entre cliente e servidor, permitindo comunicação em tempo real. O Wootdesk utiliza essa conexão para enviar atualizações instantâneas sobre eventos da plataforma. Observação: Este recurso é experimental e pode sofrer alterações entre versões. A compatibilidade retroativa não é garantida, então mantenha sempre sua implementação atualizada. Por que usar conexão WebSocket? A conexão WebSocket permite atualizações em tempo real sem necessidade de recarregar a página. Ela é ideal para: Aplicativos Android/iOS Dashboards personalizados Interfaces em tempo real SDKs próprios Sistemas omnichannel integrados ao Wootdesk Com isso, agentes recebem mensagens, mudanças de status e notificações instantaneamente. Como configurar uma conexão WebSocket no Wootdesk? Para conectar ao WebSocket do Wootdesk, você precisará de um PubSub Token. URL da conexão: wss://<seu-dominio>/cable Exemplo na cloud: wss://app.wootdesk.com/cable Tipos de PubSub Token 1. User PubSub Token Possui permissões de agente/admin e recebe todos os eventos disponíveis. Você pode obter esse token pela API de Perfil. 2. Contact PubSub Token Gerado automaticamente para cada sessão de contato. Ideal para: Widgets personalizados Apps mobile Interfaces de clientes Esse token recebe apenas eventos da própria sessão. Como conectar ao WebSocket? Exemplo de conexão: const stringify = (payload = {}) => JSON.stringify(payload); const pubSubToken = "<seu-pubsub-token>"; const accountId = "<account-id>"; const userId = "<user-id>"; const connection = new WebSocket( "wss://app.wootdesk.com/cable" ); connection.send( stringify({ command: "subscribe", identifier: stringify({ channel: "RoomChannel", pubsub_token: pubSubToken, account_id: accountId, user_id: userId, }), }) ); Mantendo usuário online (Presence) Para manter o status online, envie um evento de presença a cada 30 segundos. Atualizar presença de agente/admin const payload = stringify({ command: "message", identifier: stringify({ channel: "RoomChannel", pubsub_token: "<user-pubsub-token>", account_id: accountId, user_id: userId, }), data: stringify({ action: "update_presence" }), }); connection.send(payload); Atualizar presença de contato const payload = stringify({ command: "message", identifier: stringify({ channel: "RoomChannel", pubsub_token: "<contact-pubsub-token>", }), data: stringify({ action: "update_presence" }), }); connection.send(payload); Objetos retornados nos eventos Os eventos do WebSocket podem retornar os seguintes objetos: Conversation Contact User Message Notification Principais eventos disponíveis conversation.created Disparado quando uma nova conversa é criada. Disponível para: Agentes/Admins Contatos message.created Disparado quando uma nova mensagem é enviada. Disponível para: Agentes/Admins Contatos message.updated Disparado quando uma mensagem é editada/atualizada. conversation.status_changed Disparado quando o status da conversa muda. Exemplos: open pending resolved snoozed conversation.typing_on Disparado quando alguém começa a digitar. Inclui: conversa usuário indicador se é nota privada conversation.typing_off Disparado quando alguém para de digitar. assignee.changed Disparado quando o responsável da conversa é alterado. team.changed Disparado quando o time responsável muda. contact.created Disparado quando um contato é criado. contact.updated Disparado quando um contato é atualizado. presence.update Atualiza status online/offline de usuários e contatos em tempo real. notification_created Disparado quando uma notificação é criada. Exemplo de payload de evento { "message": { "event": "message.created", "data": { "id": 1, "content": "Olá!", "message_type": 0 } } } Casos de uso do WebSocket no Wootdesk O WebSocket é extremamente útil para: Atualização em tempo real do dashboard Sistemas mobile Widgets customizados Notificações instantâneas Indicador de digitação Presença online/offline Monitoramento omnichannel Integrações próprias Boas práticas Reenviar presença a cada 30 segundos Reconectar automaticamente em caso de queda Sempre utilizar o token mais recente Validar eventos recebidos antes de processar Utilizar SSL (wss://) em produção

Última atualização em May 21, 2026

Como usar variáveis de template?

As variáveis de template permitem personalizar mensagens automaticamente utilizando informações dinâmicas do contato, agente ou conversa. Com elas, você pode inserir: Nome do cliente Número da conversa Telefone Nome do agente E muito mais Isso funciona em: Mensagens Respostas rápidas (Canned Responses) Macros Automações Exemplo básico Se você enviar: Olá {{ contact.name }}, como posso ajudar? O Wootdesk substituirá automaticamente pela informação do contato: Olá João, como posso ajudar? Como inserir variáveis? Ao escrever uma mensagem, digite: {{ O sistema exibirá automaticamente a lista de variáveis disponíveis. Basta selecionar a desejada. Variáveis disponíveis Conversa {{ conversation.id }} ID numérico da conversa. Contato {{ contact.id }} ID do contato. {{ contact.name }} Nome completo do contato. {{ contact.first_name }} Primeiro nome. {{ contact.last_name }} Sobrenome. {{ contact.phone_number }} Telefone do contato. Agente {{ agent.name }} Nome completo do agente. {{ agent.first_name }} Primeiro nome do agente. {{ agent.last_name }} Sobrenome do agente. {{ agent.phone_number }} Telefone do agente. Exemplo completo Olá {{ contact.first_name }}, Meu nome é {{ agent.first_name }} e vou cuidar do seu atendimento. Seu protocolo é #{{ conversation.id }}. Resultado: Olá João, Meu nome é Carlos e vou cuidar do seu atendimento. Seu protocolo é #1548. Texto de fallback (valor padrão) Você também pode definir um texto alternativo caso a variável não exista. Exemplo: Olá {{ contact.first_name || 'cliente' }} Se o contato não tiver primeiro nome cadastrado: Olá cliente Importante sobre fallback O texto padrão deve estar entre aspas simples: ✅ Correto: {{ contact.first_name || 'cliente' }} ❌ Incorreto: {{ contact.first_name || cliente }} O que acontece se usar uma variável inválida? Se você utilizar uma variável inexistente, o Wootdesk exibirá um aviso informando que a variável não é válida. Exemplo: {{ contact.plan }} Caso essa variável não exista, o sistema alertará antes do envio. Onde usar variáveis? As variáveis funcionam em: Mensagens manuais Respostas rápidas Macros Automação Bots Campanhas API WhatsApp E-mail Widget do site Boas práticas Sempre utilize fallback em campos importantes Evite mensagens muito robóticas Use personalização para melhorar conversão e atendimento Teste as variáveis antes de publicar automações Utilize primeiro nome para mensagens mais naturais

Última atualização em May 21, 2026

Como usar Macros?

Uma macro é um conjunto de ações automáticas executadas em sequência dentro do Wootdesk. Ela ajuda agentes a automatizar tarefas repetitivas como: Adicionar etiquetas Alterar status Atribuir times Enviar mensagens Enviar anexos Encerrar conversas Aplicar prioridades Enviar transcrições E muito mais Por que usar macros? Sem macros, agentes precisam executar manualmente várias ações repetidas todos os dias. Exemplo comum: Sempre que chega uma solicitação de demonstração: Atribuir ao time comercial Enviar mensagem padrão Adicionar etiqueta Definir prioridade Colocar conversa em snooze Com macros, tudo isso acontece com apenas 1 clique. Como criar uma macro? Passo 1 Acesse: Configurações → Macros → Adicionar nova macro Passo 2 Você verá a tela de configuração da macro. Nela, você pode: Definir nome Criar fluxo de ações Escolher visibilidade Organizar sequência das ações Ações disponíveis O Wootdesk permite criar sequências automáticas com ações como: Atribuir agente Atribuir time Adicionar etiqueta Remover etiqueta Alterar prioridade Resolver conversa Colocar em snooze Enviar mensagem Enviar anexo Enviar transcrição Alterar status Mutar conversa Exemplo de macro Cenário Quando um lead do plano gratuito entra em contato: Adicionar etiqueta free_plan Atribuir ao time Comercial Enviar mensagem padrão Definir prioridade média Colocar conversa em snooze Ordem das ações importa As ações são executadas exatamente na ordem configurada. Exemplo: 1. Enviar mensagem 2. Adicionar etiqueta 3. Resolver conversa O sistema seguirá exatamente essa sequência. Visibilidade da macro Você pode definir: Privada Somente você poderá usar. Pública Todos os agentes da conta poderão utilizar. Como salvar? Após configurar: Clique em "Salvar Macro" Sua macro ficará disponível imediatamente. Como executar uma macro? Passo 1 Abra uma conversa. No painel lateral direito: Macros → Expandir lista Você verá: Macros privadas Macros públicas Passo 2 Opcionalmente, visualize a macro clicando no ícone de informações. Isso mostrará todas as ações que serão executadas. Passo 3 Clique no botão de executar ▶️ O Wootdesk executará automaticamente todas as ações em poucos segundos. Exemplo prático Macro: Lead Comercial Ações: - Adicionar etiqueta "lead" - Atribuir ao time Comercial - Enviar mensagem de agendamento - Definir prioridade Alta Com apenas 1 clique, todo o fluxo é executado automaticamente. Como editar ou excluir macros? Acesse: Configurações → Macros Localize a macro desejada e utilize: ✏️ Editar ❌ Excluir Boas práticas Crie macros para tarefas repetitivas Utilize nomes claros e objetivos Padronize respostas da equipe Combine macros com automações Use etiquetas para organizar fluxos Revise macros periodicamente Casos de uso comuns Suporte Encerrar tickets resolvidos Solicitar avaliação CSAT Aplicar prioridade automaticamente Comercial Qualificar leads Direcionar para SDR Enviar links de reunião Financeiro Cobrança Envio de boleto Atualização de pagamento Spam Adicionar etiqueta spam Resolver conversa Mutar conversa Diferença entre Macro e Automação Macro Executada manualmente pelo agente. Automação Executada automaticamente baseada em eventos e condições. Benefícios das Macros Mais produtividade Menos trabalho manual Respostas padronizadas Atendimento mais rápido Menos erros operacionais Melhor organização da equipe

Última atualização em May 21, 2026

Acordos de Nível de Serviço (SLA)

Os SLAs (Service Level Agreements) são acordos de nível de serviço entre sua empresa e seus clientes. Eles definem os padrões de atendimento que sua operação se compromete a cumprir, como: Tempo de primeira resposta Tempo entre respostas Tempo total de resolução Disponibilidade do suporte No Wootdesk, os SLAs ajudam sua equipe a manter um atendimento rápido, organizado e dentro dos prazos definidos. Métricas de SLA disponíveis no Wootdesk O Wootdesk permite monitorar três métricas principais: FRT (First Response Time) Tempo da Primeira Resposta Mede quanto tempo o agente leva para responder a primeira mensagem do cliente. Essa é uma das métricas mais importantes do suporte, já que clientes esperam respostas rápidas logo no início do atendimento. Exemplo: Cliente envia mensagem às 10:00 Agente responde às 10:07 ➡️ FRT = 7 minutos NRT (Next Response Time) Tempo Entre Respostas Mede quanto tempo o agente demora para responder após cada nova interação do cliente durante a conversa. Ajuda a garantir continuidade e agilidade no atendimento. Exemplo: Cliente responde às 14:20 Agente retorna às 14:28 ➡️ NRT = 8 minutos RT (Resolution Time) Tempo de Resolução Mede o tempo total necessário para resolver completamente a solicitação do cliente. Vai desde a abertura até a finalização da conversa. Exemplo: Conversa iniciada às 09:00 Conversa resolvida às 11:30 ➡️ RT = 2h30min Como criar um SLA Os SLAs podem ser configurados nas configurações da conta. ⚠️ Apenas administradores podem criar ou excluir SLAs. Importante: Um SLA não pode ser editado após criado Também não pode ser removido de uma conversa depois de aplicado Passo a passo Passo 1 Acesse: Configurações → SLA Passo 2 Clique em: Adicionar SLA Passo 3 Defina: Nome do SLA Métricas que serão monitoradas Tempos máximos permitidos Você precisa adicionar pelo menos uma métrica obrigatoriamente. Exemplo: FRT: 15 minutos NRT: 30 minutos RT: 4 horas Como aplicar um SLA automaticamente Os SLAs normalmente são aplicados usando Automations. Você pode criar regras automáticas para aplicar diferentes SLAs dependendo de: Prioridade da conversa Inbox Etiquetas Cliente Canal Tipo de suporte Exemplo prático Aplicar o SLA “Enterprise P0” quando: A conversa for criada O cliente possuir determinado e-mail A prioridade estiver como “Urgente” Nesse caso: O SLA será aplicado automaticamente Os timers começam imediatamente Como o SLA aparece nas conversas Quando uma conversa possui SLA ativo, o Wootdesk exibe indicadores visuais mostrando: Tempo restante Métricas próximas do limite Alertas de atraso Isso ajuda agentes e gestores a priorizar atendimentos críticos. Regras importantes Um SLA não pode ser removido Depois de aplicado em uma conversa, ele permanece até o encerramento. Um SLA não pode ser editado Caso precise alterar tempos ou regras: crie um novo SLA atualize suas automações Benefícios do SLA no atendimento Utilizar SLA ajuda sua operação a: Melhorar tempo de resposta Priorizar atendimentos urgentes Aumentar satisfação do cliente Monitorar performance da equipe Garantir cumprimento contratual Reduzir atrasos no suporte Dica estratégica Uma prática muito utilizada é combinar: Prioridades Etiquetas Automações SLAs Exemplo: Clientes Enterprise → SLA agressivo Clientes Free → SLA padrão Conversas urgentes → prioridade máxima + SLA reduzido Isso cria uma operação muito mais organizada e escalável.

Última atualização em May 21, 2026