Bibliotecas blocos - Habilidades prontas

Habilidades:

Onboarding

LGPD

Inatividade

Opt-In/Out

Algo Mais

Finalização

CSAT

Transbordo

Dados Pessoais

Cascata de Validação

Agente:

Caso de uso:

Cadastro

Qualificação de Leads

Bloco | [LOGIC] A.1.0.0 Validação de entrada

Utiliza-se a variável {isNewUser} nas condições de saída para identificar se é o primeiro contato do usuário, direcionando-o ao bloco correspondente. Há uma ação de registro de eventos para identificar a origem do usuário.
 

Bloco | [MSG] A.2.0.0 Sim validação

Exibe a mensagem de boas-vindas ao usuário e executa o registro de eventos (origem e exibição), além de definir a variável {isNewUser}. A condição de saída é ativada apenas se há resposta do usuário.
 

Bloco | [MSG] A.3.0.0 Não validação

Exibe mensagem de retorno para o usuário e executa o registro de eventos (origem e exibição). A condição de saída é ativada apenas se há resposta do usuário.

Bloco | [LOGIC]LP.1.0.0 - LGPD Validação

Verifica se o usuário já aceitou os termos da LGPD através da variável {userAceptedPrivacyPolicy}. O fluxo valida se a variável existe e se o valor corresponde ao aceite (Sim/Não). As ações incluem o registro de eventos de origem, o status da validação da LGPD.

Bloco | REDIRECT SERVICE

Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

Bloco | [START] 

Gerencia a entrada na habilidade validando a variável {input.content@redirectId} e encaminhando o usuário ao bloco correspondente via ID.
 

Bloco | [INPUT] LP.2.0.0 - LGPD

Apresenta as informações sobre a LGPD, incluindo link para detalhes e um menu de opções para o usuário aceitar, recusar ou solicitar mais informações.

Bloco | [LOGIC] LP.2.0.0 - [Não] Aceite LGPD

Faz a validação através de um script da opção escolhida. 

Bloco | GOTO LP.2.0.0 - Service Name

Executa o redirecionamento para outro serviço ou habilidade por meio de saída padrão caso o usuário tenha aceitado os termos.
 

Bloco | [INPUT] LP.3.0.0 - Não concorda com LGPD

Caso o usuário não aceite os termos, é exibida uma mensagem reforçando a necessidade do aceite para prosseguir. O bloco reapresenta as opções anteriores: "Aceitar", '"Não aceitar" e "Saber mais".

Bloco | LP.4.0.0 - Saber Mais

É exibido um detalhamento sobre a LGPD.
 

Bloco | [LOGIC] LP.3.0.0 - Não concorda com LGPD

Faz a validação através de um script da opção escolhida.
 

Bloco | GOTO LP.3.0.0 - Service Name

Executa o redirecionamento para outro serviço ou habilidade por meio de saída padrão caso o usuário tenha aceitado os termos.

Bloco | REDIRECT SERVICE

Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.
 

Bloco | Redirect Inatividade

Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Bloco | [INPUT] I.1.0.0 - Inatividade 

Exibe uma mensagem para confirmar se o usuário deseja prosseguir com o atendimento.
 

Bloco | [LOGIC] I.1.0.0 - Inatividade

A variável {setValidation} é utilizada para validar a decisão do usuário e determinar a continuidade ou o encerramento do fluxo.
 

Bloco | [INPUT] I.1.2.0 Encerramento

Exibe o conteúdo da mensagem de finalização.

Bloco | REDIRECT SERVICE

Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

Bloco | [INPUT] I.1.0.0 - optin

Conteúdo da mensagem de solicitação de consentimento para o envio de notificações.

Bloco | [LOGIC] I.1.0.0 - OPT-IN

Validação da opção escolhida através de um script.

Bloco | OPT 1.0.1 - Aceite Opt-in

Conteúdo de confirmação após adesão (opt-in) do usuário.

Bloco | OPT 2.0.0 - Opt out

Mensagem de confirmação de remoção da base de destinatários.

Bloco | OPT.1.0.2 - Não aceite

Conteúdo exibido após a recusa da permissão de notificações pelo usuário.

Bloco | REDIRECT SERVICE

Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

Bloco | Redirect Inatividade

Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Bloco | [INPUT] AM.1.0.0 - Algo mais

Mensagem de verificação de pendências ou suporte adicional.
 

Bloco | [LOGIC] AM.1.0.0 - Algo mais

Validação da opção escolhida por meio de um script.

Bloco | REDIRECT SERVICE

Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

Bloco | Redirect Inatividade

Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Bloco | F.1.0.0 - Finalização 

Mensagem de encerramento com instruções para reabertura do contato.

Bloco | REDIRECT SERVICE

Executa o redirecionamento para outro serviço ou habilidade por meio de uma ação de saída.

Bloco | [START] 

Controla o acesso à habilidade validando a variável {{input.content@redirectId}} para direcionar o usuário ao bloco de destino correspondente.

Bloco | [MSG] C.1.0.0 Pergunta Resolutividade

Mensagem de confirmação enviada ao usuário para validar se sua solicitação foi resolvida antes de encerrar o fluxo.

Bloco | [LOGIC] C.1.0.0 Pergunta Resolutividade

A validação da opção selecionada é realizada via script, utilizando a variável {{userInput}} diretamente nas condições de saída para determinar o próximo passo do fluxo.

Bloco | [MSG] C.1.0.1 Resolutividade negativa

Exibe o conteúdo da mensagem perguntando o que pode ser melhorado.
 

Bloco | [MSG] C.1.1.1 Pergunta CSAT

Exibe o conteúdo da mensagem perguntando a nota de avaliação.

Bloco | [LOGIC] C.1.1.1 Pergunta CSAT

Validação da nota de avaliação realizada via script utilizando a variável {{userInput}} para processar a pontuação recebida.
 

Bloco | [MSG] C.1.1.2 Finaliza CSAT

Exibe o conteúdo da mensagem de finalização.
 

Bloco | Redirect Finish

Redireciona o serviço para a habilidade de finalização.
 

Bloco | Redirect Inatividade

Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Bloco | Customer service 

Configura as regras de disponibilidade para gerenciar o fluxo quando não houver atendentes ou o contato ocorrer fora do horário de operação.
 

Bloco | ATH.1.0.0 Nenhum atendente disponivel

Mensagem de indisponibilidade que informa a ausência de atendentes e questiona se o usuário deseja aguardar na fila.

Bloco | ATH 1.1.0 Aguarde

Mensagem de espera orientando o usuário a aguardar o início do atendimento.

Bloco | ATH 1.2.0 Despedida

Mensagem de encerramento que instrui o usuário sobre qual termo ou ação utilizar para reiniciar a conversa.

Bloco | ATH2.0.0 Fora do horário

Mensagem informativa sobre o encerramento do expediente que apresenta os horários de funcionamento do canal.

Bloco | REDIRECT SERVICE

Redireciona o usuário para outro serviço ou habilidade utilizando uma ação de saída configurada no bloco.

Bloco | Redirect Inatividade

Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Bloco | [START]

Gerencia a entrada na habilidade validando a variável {{input.content@redirectId}} e encaminhando o usuário ao bloco correspondente via ID.
 

Bloco | [MSG] Mensagem intro

Mensagem introdutória que comunica ao usuário o início da coleta de dados.

Bloco | [LOGIC] DC.1.0.0 Pedir cpf?

Nas ações de entrada, a variável {{dadosPessoais}} define quais informações serão coletadas e valida a necessidade de solicitar o CPF.

Bloco | [MSG] DC.1.0.1 Pedir CPF

Mensagem que solicita ao usuário o número do CPF para prosseguir com o cadastro.
 

Bloco | [MSG] DC.1.0.1 Pedir CPF Validacao

Validação do formato e da autenticidade do CPF via script, utilizando a variável {{isValidCpf}} para registrar o documento nos parâmetros do contato.
 

Bloco | [LOGIC] DC.1.1.0 Pedir Nome?

Verifica se a coleta do nome está habilitada na variável {{dadosPessoais}}.

Bloco | [MSG] DC.1.1.1 Pedir Nome

Mensagem que solicita ao usuário o preenchimento do nome completo.

Bloco | [LOGIC] DC.1.1.1 Pedir Nome Validacao

Validação do formato nominal via script utilizando a variável {{nameValidation}} para registrar o nome nos parâmetros do contato.

Bloco | [LOGIC] DC.1.2.0 Pedir E-mail?

Verifica se a coleta de e-mail está habilitada na variável {{dadosPessoais}}.
 

Bloco | [MSG] DC.1.2.1 Pedir E-mail

Mensagem que solicita ao usuário o endereço de e-mail para contato ou cadastro.

Bloco | [LOGIC] DC.1.2.1 Pedir E-mail validacao

Validação do formato e da autenticidade do e-mail via script utilizando a variável {{hasEmail}} para registrar o endereço nos parâmetros do contato.

Bloco | [LOGIC] DC.1.3.0 Pedir Telefone?

Verifica se a coleta de e-mail está habilitada na variável {{dadosPessoais}}.

Bloco | [MSG] DC.1.3.1 Pedir Telefone

Mensagem que solicita ao usuário o número de telefone para contato.
 

Bloco | [MSG] DC.1.3.1 Pedir Telefone validacao

Validação do formato e da autenticidade do telefone via script utilizando a variável {{phoneNumber}} para registrar o número nos parâmetros do contato.

Bloco | [MSG] Mensagem transição

Mensagem de confirmação que informa ao usuário a conclusão bem-sucedida da coleta de seus dados.

Bloco | REDIRECT SERVICE

Redireciona o usuário para outro serviço ou habilidade utilizando uma ação de saída configurada no bloco.

Bloco | Redirect Inatividade

Realiza o redirecionamento para a habilidade de inatividade, garantindo o retorno ao ponto de espera de entrada do usuário.

Integração IA: Valida a conexão e o processamento junto ao provedor de Inteligência Artificial.

Devem ser definidas as variáveis de configuração: {{config.AuthorizationApiKeyIA}} e {{config.commandsUrl}}

<objetivo>Coletar e validar NOME, EMAIL e TELEFONE do usuário em pt-BR.</objetivo>

  <diretrizes>

    <tons>educado, direto, uma pergunta por vez</tons>

    <regras>

      <regra>Nunca prossiga para o próximo campo se o atual estiver inválido.</regra>

      <regra>Sempre explique por que a entrada é inválida e mostre um exemplo válido.</regra>

      <regra>Ao final, confirme o resumo dos dados antes de encerrar.</regra>

    </regras>

  </diretrizes>

  <fluxo>

    <passo>Peça o NOME completo.</passo>

    <passo>Valide e normalize o NOME.</passo>

    <passo>Peça o EMAIL.</passo>

    <passo>Valide o EMAIL.</passo>

    <passo>Peça o TELEFONE (aceite BR e internacional).</passo>

    <passo>Valide e normalize o TELEFONE.</passo>

    <passo>Mostre o resumo e peça confirmação (Sim/Não).</passo>

  </fluxo>

  <campos>

    <campo id="nome">

      <pergunta>Qual é seu nome completo?

Pode ser apenas nome e sobrenome</pergunta>

      <validacao>

        <tipo>regex</tipo>

        <padrao>^(?=.{3,100}$)(?:[A-Za-zÀ-ÖØ-öø-ÿ]+(?:['\-][A-Za-zÀ-ÖØ-öø-ÿ]+)?\s+){1,}[A-Za-zÀ-ÖØ-öø-ÿ]+$</padrao>

        <falha>Informe nome e sobrenome, usando apenas letras, espaços e acentos.

Ex.: "Fulano Silva".</falha>

      </validacao>

      <normalizacao>

        <acao>trim espaços; colapsar múltiplos espaços; Title Case.</acao>

      </normalizacao>

    </campo>

    <campo id="email">

      <pergunta>Qual é seu e-mail?</pergunta>

      <validacao>

        <tipo>regex</tipo>

        <padrao>^[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}$</padrao>

        <falha>E-mail inválido. Use o formato "usuario@dominio.com".</falha>

      </validacao>

      <normalizacao>

        <acao>trim; converter domínio para minúsculas.</acao>

      </normalizacao>

    </campo>

    <campo id="telefone">

      <pergunta>Qual é seu telefone com DDD? (ex.: (DD) XXXXX-XXXX </pergunta>

      <validacao>

        <tipo>regex-multiplo</tipo>

        <padraoE164>^\+?[1-9]\d{7,14}$</padraoE164>

        <padraoBR>^(?:\+55\s?)?(?:\(?\d{2}\)?\s?)?(?:9?\d{4})-?\d{4}$</padraoBR>

        <falha>Telefone inválido. Exemplos: "(DD) XXXXX-XXXX".</falha>

      </validacao>

      <normalizacao>

        <acao>remover caracteres não numéricos (exceto +); se for BR sem +55, prefixar +55; formatar saída em E.164 (ex.: +5531912345678).</acao>

      </normalizacao>

    </campo>

  </campos>

  <mensagens>

    <inicial>Vamos prosseguir com um cadastro rápido. Começando pelo seu nome completo.</inicial>

    <resumo>Confira os dados:

Nome: {nome}

E-mail: {email}

Telefone: {telefone}.

Estão corretos?</resumo>

    <confirmado>Perfeito! Cadastro concluído.</confirmado>

    <correcao>Sem problemas, vamos ajustar. Qual campo deseja corrigir? (nome/email/telefone)</correcao>

  </mensagens>

<handoff>

Se usuário disser "sim" → redirecionar para "novo bloco".

</handoff>

  <saida>

    <formatoJSON>

      {

        "nome": "{nome_normalizado}",

        "email": "{email_validado}",

        "telefone": "{telefone_E164}"

      }

    </formatoJSON>

  </saida>