Com a flexibilidade adicional de armazenar dados em Objetos Personalizados, seus clientes podem automaticamente ver informações como pedidos recentes que fizeram, e poderão selecionar dados desse objeto e até realizar ações como cancelar um pedido.
1. Crie um Objeto Personalizado
Primeiro, vá para Dados de objeto personalizado nas suas configurações e crie um novo Objeto Personalizado com os campos que precisar - como preço, avaliação, etc.
2. Crie referências para pessoas e conversas
Em seguida, vá para seus Dados de conversa nas suas configurações e crie uma nova referência da conversa para seu objeto - neste exemplo, chamamos nosso objeto de Pedido. Aqui, ative o botão "Permitir referenciar múltiplos Pedidos" pois uma conversa pode ter múltiplos pedidos referenciados. Saiba mais sobre como configurar referências com Objetos Personalizados
Depois, vá para Dados de pessoas e crie uma nova referência para seu objeto Pedidos. Aqui também, ative o botão "Permitir referenciar múltiplos Pedidos" pois uma pessoa pode ter múltiplos pedidos feitos.
3. Configure um Conector de Dados
O próximo passo é configurar seu Conector de Dados que buscará os dados e os armazenará no objeto Pedido.
Ao configurar seu Conector de Dados, selecione as referências que criamos em passo 2 na seção Atualizar referências de Pessoas ou Conversas para Pedido da configuração de Resposta:
4. Configure seu Workflow
Vá para Fin AI Agent > Workflows e clique em + Novo workflow.
Crie um Workflow do zero e escolha um gatilho como "Cliente abre uma nova conversa no Messenger".
Finalize a configuração das regras do gatilho e então clique em Salvar e fechar para começar a construir seu Workflow. Agora você pode personalizar o caminho de boas-vindas e os botões de resposta.
Por exemplo, a partir de um botão de resposta você pode adicionar um caminho que permite ao usuário ver seus pedidos. Neste caminho, clique no botão + e escolha Conector de Dados (usando API).
No menu suspenso, escolha seu Conector de Dados e então adicione um caminho de falha para dar contexto aos usuários caso seu Conector de Dados não consiga completar.
Então, clique novamente no botão + e desta vez, escolha Botões de Objetos Personalizados.
Adicionar botões de Objetos Personalizados apresentará os seguintes campos para completar:
Selecionar dados...
Nenhum dos acima
Salvar seleção em...
Clique em Selecionar dados e no menu, selecione:
De - o objeto para o qual você quer exibir botões, no nosso caso Pedidos.
Onde - atributo de referência para conversa ou pessoas, no nosso caso é "Pedidos na conversa para Conversa do contexto". Isso exibirá cada instância do objeto associada à conversa atual.
Número de botões - isso limita o número de itens que serão recuperados (máximo 25).
O que os botões devem mostrar - para este exemplo, queremos exibir o nome de um item que foi pedido.
Em seguida, clique em Salvar seleção em e então + Vincular Conversa ao Pedido.
Isso o levará de volta para Dados de conversa onde você pode clicar em + Criar atributo e criar uma nova referência para o objeto Pedido que armazenará a seleção feita no seu Workflow.
Certifique-se de que o botão "Permitir referenciar múltiplos Pedidos" esteja desligado pois essa referência armazenará apenas um único objeto (selecionado) do Workflow.
Agora volte para a aba do seu Workflow e Salve as alterações, depois atualize a página para carregar o novo atributo de referência criado:
Nota: Cada uma dessas respostas representa uma Instância de Objeto Personalizado, as respostas são ordenadas pelo valor external_updated_at dessa Instância de Objeto Personalizado.
O valor mais recente de external_updated_at estará no topo da lista e o valor mais antigo de external_updated_at estará na parte inferior da lista (mais próximo de "Nenhum dos acima").
Você precisará definir o valor external_updated_at para cada instância de acordo com a ordem desejada.
5. Exiba dados do Objeto Personalizado para seu usuário
Quando o usuário selecionar um pedido, isso salvará a seleção na referência Pedido selecionado e você poderá exibir dados desse objeto diretamente nas mensagens do seu Workflow.
Para isso, adicione um caminho a partir do botão Selecionar dados (Pedidos > Nome_do_item neste exemplo). Então, você pode clicar no botão seletor de atributo {..} e escolher o atributo apropriado que deseja mostrar.
Dica: Se você tiver múltiplas referências de Objetos Personalizados, pode garantir que escolheu a correta olhando o título no seletor de atributos - por exemplo, acima, estamos escolhendo a referência Conversa > Pedido selecionado (pedido):
Nota: Ao testar um Workflow configurado para entregar botões criados a partir de um Objeto Personalizado, você precisará fazer isso em uma instância do Messenger 'Ao vivo' - o recurso Visualização do Workflow NÃO consegue acessar seu Objeto Personalizado e, portanto, não exibe os botões como esperado.
Agora coloque seu workflow no ar e você está pronto para começar! 🎉
Visualizando dados da instância de Objeto Personalizado na Inbox
Quando seus users começarem a interagir com seu Workflow, você vai querer ver quais pedidos o Conector de Dados retornou para a solicitação deles e qual pedido eles escolheram.
Você pode fazer isso olhando a barra lateral de detalhes da conversa. Neste exemplo, todos os pedidos buscados para a conversa aparecerão sob o atributo de referência "Pedidos para Conversa" e o pedido selecionado é armazenado sob "Pedido Selecionado":
Você pode ler mais sobre dados de objeto personalizado na Inbox aqui.