Configurando sua integração OmniChat <> Tray
A integração entre a OmniChat e a Tray permite utilizar os produtos da sua loja durante os atendimentos, consultar estoque e frete, criar carrinhos e enviar ao consumidor o link para finalizar a compra no checkout da Tray.
Também é possível acompanhar as atualizações dos pedidos e recuperar carrinhos abandonados.
Antes de começar
Para realizar a configuração, você precisa:
Ter acesso administrativo à loja Tray;
Ter permissão para instalar aplicativos;
Ter acesso às configurações de integrações da OmniChat;
Como autorizar a OmniChat na Tray
Passo 1: Acesse o painel administrativo da sua loja Tray.
Passo 2: Acesse "Aplicativos" e procure pelo aplicativo OmniChat e clique em Instalar aplicativo.
Passo 3: Na tela do aplicativo, clique em Instale agora ou Iniciar.
Passo 4: Após isso, serão apresentados os dados necessários para configurar a integração, copie esses dados pois iremos utilizar.
Atenção: o código de autorização é utilizado uma única vez. Não compartilhe esse código e não tente reutilizá-lo em outra integração.
Se o aplicativo já estiver instalado, acesse Meus Aplicativos, localize a OmniChat e clique em Acessar para consultar ou renovar a autorização. Esse é o fluxo previsto pela documentação oficial da Tray.
Solicitar cadastro de webhook
Para recebermos atualizações de status dos seus pedidos, estoque de produtos, preços, etc. É necessário o um cadastro de webhook na plataforma da tray, entretanto esse cadastro é realizado pela suporte da tray. Para isso acesse aqui.
Uma vez na tela você irá preencher as informações com seus dados da Tray, no campo Tipo de Parceria irá selecionar Agência e no campo Como o time de Parcerias técnico pode te ajudar? irá selecionar Integração e depois Dúvida de Webhook
O texto para sua solicitação deve ser:
Assunto: Cadastro de URL de notificação (webhooks) para aplicativo parceiro
Aplicativo: Omnichat
Consumer key: 23fb97b1f77a33205ef0b3e7ae7b54ef8a23cd07b3cca85c0d8daa163a75af21
Solicito o cadastro da URL de notificação abaixo para o aplicativo: https://tray-adapter.omni.chat/v1/platform-webhooks
Escopos a habilitar: produtos, pedidos, preço do produtos, estoque dos produtos, variações, preço das variações, estoque das variações, pagamentos, dados da loja, cobrança de pedidos, perfil de cliente/lista de preço
A URL é externa, HTTPS, aceita POST com corpo x-www-form-urlencoded (seller_id, scope_id, scope_name, act) e responde HTTP 200.
Como criar a integração na OmniChat
Passo 1: Na plataforma OmniChat, acesse: Configurações > Integrações
Passo 2: Na tela de integrações, selecione E-Commerce/ERP. Clique em Nova integração e escolha Tray.
Preenchendo o formulário
Nome
Insira o nome de exibição da integração. Este nome será utilizado internamente para identificar a integração na plataforma.
Times
Ao associar um ou mais times, a integração ficará disponível exclusivamente para os membros desse(s) time(s).
Endereço da API
Cole o endereço obtido após autorizar o aplicativo na Tray.
O endereço deve corresponder à API da sua loja e terminar em /web_api.
Exemplo: https://minhaloja.commercesuite.com.br/web_api
Código de autorização
Cole o código do aplicativo gerado pela Tray. Esse código é usado somente durante a ativação. Ao editar uma integração existente, deixe o campo vazio, exceto quando precisar autorizar novamente.
URL do e-commerce
A URL do e-commerce é o endereço da sua loja na internet. Ela será utilizada para gerar o link do carrinho de compras que será enviado para seus clientes.
URL de checkout (opcional)
A URL do checkout é o endereço para onde seus clientes serão direcionados para finalizar a compra. Deve corresponder ao caminho do checkout da sua loja.
Salvar Configurações
Após preencher todos os campos necessários, clique em "Salvar". Isso permitirá a consulta em tempo real dos produtos de sua loja.
Conclusão
Com estes passos concluídos, a integração entre OmniChat e Tray irá entrar na fase de processamento, pois as consultas as APIs da Tray são limitadas, com base nesse cenário importamos os produtos para que seu limite de uso não seja afetado.
Uma vez processada, o status da integração será alterado para "Ativa", você poderá consultar produtos diretamente nas conversas, compartilhar detalhes com clientes e criar pedidos diretamente na plataforma OmniChat. Aproveite para maximizar as vendas e a eficiência de seus vendedores.