Como capturar informações de um usuário em uma conversa de bate-papo Facebook Messenger.

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • Use a coleção de controles de entrada fornecida por Designer do Virtual Agent para solicitar e capturar informações do usuário em uma conversa de bate-papo Facebook Messenger.

    O Designer do Virtual Agent é uma ferramenta de diagrama para criar e gerenciar tópicos, que são planos gráficos para conversas entre um Virtual Agent e o usuário. Para obter mais informações, consulte Comece com Designer do Virtual Agent.

    A aplicação Integração conversacional com Facebook Messenger oferece suporte aos seguintes controles de entrada do usuário em Designer do Virtual Agent.

    Tabela 1. Controles de entrada do usuário compatíveis.
    Controle de entrada do usuário. Descrição
    Texto O usuário insere uma cadeia de caracteres de texto sem formatação na conversa.

    O limite máximo é de 5000 caracteres.

    Opção estática O usuário seleciona um item de uma lista de seleção predefinida.

    Em uma resposta rápida, o rótulo tem o limite máximo de 20 caracteres. Um usuário pode exibir apenas 13 respostas rápidas por vez. Se houver mais de 13 respostas rápidas, o formato de paginação será usado para exibir mais opções. O valor padrão do número máximo de respostas para uma página é definido na propriedade do sistema sn_va_fb_messenger.max_quick_replies (local: tabela Propriedade do sistema [sys_properties]).
    Booliano O usuário insere uma resposta booliana para o bot. Por exemplo, o usuário pode responder Sim ou Não na conversa de bate-papo.
    Seletor de arquivos O usuário envia um arquivo para o bot.

    Os tipos de arquivo compatíveis são JPG, PNG, MPG e MP4.

    Observe os seguintes pontos sobre o limite máximo de tamanho de um tipo de arquivo:

    • Para imagens, o limite máximo de tamanho é de 10 MB.
    • Para vídeos, o limite máximo de tamanho é 200 MB.
    Data e hora O usuário seleciona uma data do calendário, um horário (horas e minutos) ou ambos.
    Nota:
    Se o administrador tiver definido a opção de solicitar o fuso horário do cliente, a data e hora selecionadas refletirão o fuso horário do cliente. Caso contrário, elas estarão no fuso horário UTC. Para obter mais informações sobre a configuração de fuso horário, consulte 1.f.
    Carrossel O usuário seleciona um único item do carrossel.

    Em um carrossel, o título da imagem tem um limite máximo de 40 caracteres e o texto da imagem tem um limite máximo de 60 caracteres. Um usuário pode exibir apenas 10 imagens por vez. Se houver mais de 10 imagens, o formato de paginação será usado para exibir mais opções. O valor padrão do número máximo de imagens em um carrossel para uma página é definido na propriedade do sistema sn_va_fb_messenger.max_carousel_cards (local: tabela Propriedade do sistema [sys_properties]).

    Para obter mais informações sobre configuração de controles de entrada do usuário, consulte controles de entrada do usuário Designer do Virtual Agent.

    A aplicação Integração conversacional com Facebook Messenger oferece suporte às seguintes respostas de bot em Designer do Virtual Agent.

    Tabela 2. Respostas de bot compatíveis.
    Resposta de bot. Descrição
    Texto O bot envia uma cadeia de caracteres de texto sem formatação para o usuário.
    Imagem O bot envia uma imagem para o usuário.
    Link O bot envia um link da Web para o usuário.
    Nota:
    O link da Web aparece como um botão de URL na conversa.
    Cartão O bot envia informações selecionadas de um registro na instância.
    Nota:
    Você também pode retornar resultados de pesquisa como respostas de bot em conversas de bate-papo Facebook Messenger quando não há tópicos relevantes a serem exibidos para os usuários finais. Para obter mais informações, consulte Melhorar a experiência do usuário com o Pesquisa com IA.

    Para obter mais informações sobre configuração de respostas de bot, consulte respostas de bot Designer do Virtual Agent.