Saltar para o conteúdo principal

Conexão de Topsort com sistemas de gestão de pedidos

Os sistemas de gestão de pedidos (OMS), como Vantage, Boostr, ADvendio e Placements.io, ajudam os varejistas a gerenciar o planejamento de campanhas, as reservas e o inventário. Você pode integrar estes sistemas com as APIs de Topsort para automatizar a criação e gestão de campanhas.
Este guia mostra como integrar OMS com Topsort utilizando as APIs existentes para fluxos de trabalho de campanhas automatizadas.
Diagram showing oms connectivity

Fluxos de trabalho

A integração do OMS envolve três fluxos de trabalho principais para diferentes funções e momentos:

Como funciona a integração de OMS

  1. Planejamento de campanhas: As equipes de vendas planejam as campanhas em sua interface OMS.
  2. Criação automatizada: OMS envia dados de campanha ao Topsort através de chamadas à API.
  3. Atualizações em tempo real: As notificações de webhook mantêm os sistemas sincronizados.
  4. Relatórios unificados: Os dados de desempenho são enviados de volta aos painéis de controle de OMS.
Benefício para a empresa: A integração com OMS elimina a configuração manual de campanhas, reduz erros e permite que as equipes de vendas gerenciem campanhas em grande escala sem aprender novas ferramentas.

Exemplo de implementação

Criação de campanhas a partir de dados de OMS

Função: Gestores de campanhas/Equipes de vendas | Frequência: Por campanha

Integração de webhook para atualizações em tempo real

Referência da API

APIs Topsort atuais para integração

Autenticação

Operações de campanha em massa

Recuperação de dados de desempenho para painéis de controle de OMS

Função: Equipes de Marketing | Frequência: Contínua/Programada

Melhores Práticas

Sincronização de dados

  • Mapeamento de campos: Mapeie os campos de campanha de OMS aos parâmetros da API Topsort.
  • Validação de dados: Validar os dados da campanha antes de enviá-los às APIs de Topsort
  • Operações em massa: Utilize o processamento em lote para a gestão de campanhas em escala empresarial.

Tratamento de erros

  • Lógica de nova tentativa: Implementar um recuo exponencial para as chamadas falhadas à API
  • Registro completo: Acompanhamento de todas as interações e falhas de API
  • Monitoramento de saúde: Configurar alertas para problemas de integração

Segurança

Requisitos de segurança: As integrações de OMS gerenciam campanhas confidenciais e dados financeiros. Garantir a autenticação adequada, a validação de dados e a segurança de gestão de chaves API.
  • Gestão de chaves API: Armazene as chaves API de forma segura e faça rotação periódica.
  • Limitação de taxa: Respeite os limites de taxa de API para evitar a limitação de largura de banda.
  • Sanitização de entrada: Validar todos os dados antes de enviá-los às APIs.

Guia de implementação

1

Configuração de acesso à API

Obtenha as chaves da API Topsort e configure a autenticação:
  • Solicite a chave avançada de API ao seu representante de Topsort
  • Armazene as chaves API de forma segura em suas variáveis de ambiente
  • Configure os cabeçalhos de autenticação para todas as chamadas à API
2

Configuração de webhook

Configure os endpoints de webhook para atualizações de campanha em tempo real:
  • Crie um ponto de conexão webhook em seu sistema OMS
  • Registre a URL do webhook com Topsort para eventos de campanha
  • Implemente manipuladores para eventos de criação/atualização/exclusão de campanhas
3

Mapeamento de campos de dados

Mapeie os campos da campanha de OMS aos parâmetros da API Topsort:
  • Documente o mapeamento de campos entre sistemas
  • Implemente a lógica de transformação de dados
  • Verifique que os campos obrigatórios estejam presentes
4

Implementação do tratamento de erros

Implemente uma lógica integrada de tratamento de erros e novas tentativas:
  • Implementar recuo exponencial para chamadas falhadas à API
  • Adicionar registro completo para depuração
  • Configurar alertas para falhas de integração
5

Testes e validação

Teste a integração com dados de teste antes da produção:
  • Criar campanhas de teste através do fluxo de trabalho de OMS
  • Verificar que as campanhas apareçam corretamente no Topsort
  • Testar entrega e manipulação de webhooks
6

Monitoramento e manutenção

Estabeleça um sistema de monitoramento contínuo para a integração:
  • Acompanhar as taxas de sucesso/falha das chamadas à API
  • Supervisionar o desempenho da criação de campanhas
  • Configurar painéis de controle para o estado da integração

Recursos relacionados


Pronto para integrar seu OMS com Topsort? Entre em contato com seu representante de conta para começar com o acesso à API e o suporte de implementação.