Tags Dinâmicas

As Tags Dinâmicas são recursos especiais da Conversation API que permitem criar fluxos interativos e personalizados no Lifty. Elas são divididas em três categorias principais e oferecem controle total sobre a experiência do usuário.

🎯 Visão Geral

As Tags Dinâmicas são recursos especiais que permitem:

• Controle de fluxo de atendimento (Live Chat)
• Input dinâmico com listas e seleções interativas
• Respostas personalizadas baseadas em dados selecionados
• Formatação rica de mensagens (imagens, vídeos, botões)
• Integração com sistemas externos (CRM, ERP, APIs)
• Automação de processos complexos

🏪 Live Chat Tags

Essas tags controlam o fluxo de atendimento quando o live chat está habilitado.

#isOpen - Validação de Horário

Valida automaticamente se o estabelecimento está dentro do horário de funcionamento configurado.

Sintaxe:

#isOpen{SETOR}

Parâmetros:

• SETOR: Nome do setor que será chamado se o estabelecimento estiver fechado

Como funciona:

• ✅ Estabelecimento aberto: Continua o fluxo normal da conversa
• ❌ Estabelecimento fechado: Redireciona para o SETOR especificado

Caso de uso típico:

Usuário: "Quero agendar um horário"
Bot: #isOpen{GERAL}
     "Desculpe, estamos fechados. Nosso horário é..."

#human - Transferência para Atendimento Manual

Transfere automaticamente o atendimento para um agente humano quando necessário.

Sintaxes:

#human{}                    // Setor GERAL (padrão)
#human{SETOR}               // Setor específica
#human{SETOR; EMAIL}        // Setor + agente específico

Parâmetros:

• SETOR: Nome do SETOR de atendimento (ex: SUPORTE, VENDAS, FINANCEIRO)
• EMAIL: Email do agente responsável (opcional)

Exemplos práticos:

#human{}                           // Setor geral - qualquer agente disponível
#human{SUPORTE}                    // Setor de suporte técnico
#human{VENDAS; joao@empresa.com}   // Setor de vendas + João específico
#human{URGENTE; maria@empresa.com} // Setor urgente + Maria

Caso de uso típico:

Usuário: "Preciso falar com um humano"
Bot: #human{SUPORTE}
     "Transferindo você para nossa equipe de suporte..."

🎨 Tags de formatação

Essas tags criam formatação rica e elementos interativos.

#image - Imagens

Envia uma imagem no canal.

Sintaxe:

#image{URL}

Exemplo:

#image{https://exemplo.com/logo.png}

#document - Documentos

Envia um documento anexo.

Sintaxe:

#document{URL}

#video - Vídeos

Envia um vídeo (YouTube).

Sintaxe:

#video{URL_YOUTUBE}

#link - Links com Prévia

Envia um link com prévia.

Sintaxe:

#link{URL}

#audio - Áudios

Envia um áudio (.oga).

Sintaxe:

#audio{URL}

#contact - Contatos

Envia um contato (apenas WhatsApp).

Sintaxe:

#contact[TELEFONE]

#break - Pausas

Cria pausas para tornar a conversa mais natural.

Sintaxe:

#break{MILISSEGUNDOS}

Exemplo:

#break{2000}  // Pausa de 2 segundos

#LIST - Listas de Opções

Cria uma lista interativa de opções.

Sintaxe:

#LIST-->
#title{LABEL; TITULO}
#option{TEXTO; SUBTITULO}
#option{TEXTO; SUBTITULO}
--*

Exemplo:

#LIST-->
#title{Clique aqui; Selecione uma opção}
#option{🎥 Vídeos; Exemplo de vídeo}
#option{🔊 Áudios; Exemplo de áudio}
#option{📆 Agendamentos; Teste um agendamento}
--*

#BUTTONS - Botões

Cria botões interativos.

Sintaxe:

#BUTTONS-->
#title{TEXTO_TITULO}
#button{TEXTO_BOTAO}
#button{TEXTO_BOTAO}
--*

Exemplo:

#BUTTONS-->
#title{Clique nos botões abaixo 👇🏻}
#button{Agendamentos} 
#button{Cancelamentos}
--*

#FOREACH - Iteração em Arrays

Itera sobre arrays de dados de APIs externas.

Sintaxe:

--FOR[
${VARIAVEL.CAMPO}: ${VARIAVEL.CAMPO}
]--

Exemplo:

--FOR[
${horarios.letra}: ${horarios.horario}
]--
Por favor informe o horário desejado para continuar.

JSON de exemplo:

{
    "horarios": [
        {"letra": "A", "horario": "08:00"},
        {"letra": "B", "horario": "10:00"},
        {"letra": "C", "horario": "14:00"}
    ]
}

⚠️ Limitações e Considerações

Limitações Técnicas

• Máximo de 5 botões por mensagem
• Tamanho máximo: 4096 caracteres
• URLs: Devem ser públicas e acessíveis
• Formatos: Áudio apenas .oga, vídeo apenas YouTube

Boas Práticas

• Sempre teste as tags antes de usar em produção
• Use índices consistentes entre input e reply tags
• Mantenha URLs válidas para mídia
• Configure modelos dinâmicos adequadamente
• Documente fluxos complexos

Troubleshooting

Tag não funciona:

1. Verifique a sintaxe
2. Confirme se as dependências estão atendidas
3. Teste com valores simples primeiro
4. Verifique logs do sistema

Formatação não aparece:

1. Verifique se o canal suporta a formatação
2. Confirme se as URLs são válidas
3. Teste com formatação básica primeiro

Este guia será atualizado conforme novas funcionalidades forem disponibilizadas na plataforma.