Como adicionar uma API ERP

Atualizado em

No SyBox, isso é feito em Definições > Integrações > APIs de ERP. 1) Vá em Definições > Integrações > APIs de ERP. 2) Clique em "Adicionar API ERP". 3) Selecione o "Tipo" (conforme os três modelos explicados acima). 4) Informe o "Nome de exibição", identificando o nome completo da integração. 5) Defina o "Nome do botão", o texto curto que os atendentes verão no botão ou menu. 6) Em "Ícone do botão", escolha o ícone de exibição. 7) Em "URL da API ERP", cole o endpoint do seu…

  1. Vá em Definições > Integrações > APIs de ERP.
    Settings, ERP APIs: a connected stock system that shows as a button in conversations
  2. Clique em "Adicionar API ERP".
    The new ERP API window: its type first, then its name, button and address
  3. Selecione o "Tipo" (conforme os três modelos explicados acima).
  4. Informe o "Nome de exibição", identificando o nome completo da integração.
  5. Defina o "Nome do botão", o texto curto que os atendentes verão no botão ou menu.
  6. Em "Ícone do botão", escolha o ícone de exibição.
  7. Em "URL da API ERP", cole o endpoint do seu sistema. Ele deve começar obrigatoriamente com http:// ou https://.
  8. Em "Token do ERP", informe o token de autenticação do seu sistema, caso utilize. O SyBox envia esse token a cada requisição para validação de segurança.
  9. Opcional: em "Cabeçalhos personalizados", clique em "Adicionar cabeçalho" para enviar parâmetros extras de chave/valor junto às requisições, como código de filial. Cada cabeçalho possui uma chave individual para pausar sem precisar excluir. Use a lixeira para remover. Nomes de cabeçalho reservados pelo SyBox são desconsiderados.
  10. Clique em Salvar.

Perguntas

Configurei uma API ERP, mas o botão não aparece junto ao chat.

Verifique se o card da integração está marcado como "Ativo". Lembre-se de que "Aba lateral" e "Produtos" viram botões na barra lateral, enquanto "Ação de mensagem" aparece apenas dentro do menu de contexto de uma mensagem de WhatsApp recebida.

O painel se abre, mas não traz dados ou exibe mensagem de erro.

O SyBox apenas reproduz o conteúdo retornado pela sua API. Verifique se o endereço da API está acessível publicamente na internet, se o token informado está correto e se o seu sistema consegue localizar o cliente pelo número de telefone (ou por e-mail, em atendimentos via e-mail).

Posso cadastrar mais de um sistema externo?

Sim. Adicione quantas APIs de ERP forem necessárias. Cada cadastro criará seu próprio botão no atendimento.

Quem tem acesso para visualizar as informações do painel?

Qualquer membro da equipe com permissão para visualizar aquela conversa na caixa de entrada.

Mais sobre APIs de ERP.