Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.nemu.com.br/llms.txt

Use this file to discover all available pages before exploring further.

A API da Nemu permite que você envie eventos de vendas para o dashboard em tempo real, expandindo as funcionalidades do seu aplicativo.

​
Autenticação

Inclua o token do dashboard no header Authorization da sua requisição.

​
Gerando o Token do Usuário

  1. Na Nemu, acesse Configurações > API Nemu.
  1. Clique em Gerar token.
  1. Copie o token exibido.
Mantenha o token em segurança. Ele é único e deve ser usado apenas em requisições autorizadas.

​
Recuperando UTMs para Integração

Para enviar dados de vendas com informações de rastreamento (UTMs), você deve recuperar essas informações de uma das três fontes disponíveis na seguinte ordem de prioridade:

​
Fontes de UTMs Disponíveis

  1. Variável Global (Prioridade 1): window.trackingNemu.nemuUtms
    • Retorna um objeto URLSearchParams com as UTMs
    • Disponível quando o pixel da Nemu está carregado na página
  2. Cookie (Prioridade 2): nemuUtmsTrack
    • Cookie contendo as informações de UTMs em formato de query string
  3. LocalStorage (Prioridade 3): nemu:utmsTrack
    • Armazenamento local com as UTMs em formato de query string

​
Implementação Recomendada

// Função auxiliar para obter cookies
function getCookie(name) {
  const value = `; ${document.cookie}`;
  const parts = value.split(`; ${name}=`);
  if (parts.length === 2) return parts.pop().split(";").shift();
}

// Recuperação de UTMs com fallback
const utms =
  window.trackingNemu?.nemuUtms?.toString() ||
  getCookie("nemuUtmsTrack") ||
  localStorage.getItem("nemu:utmsTrack");

​
Estratégia de Fallback

A implementação deve seguir a ordem de prioridade, tentando primeiro a variável global, depois o cookie e por último o localStorage. Isso garante que as UTMs sejam capturadas independentemente de como o usuário chegou à página.
A variável global window.trackingNemu.nemuUtms só estará disponível se o pixel da Nemu estiver carregado na página. Use o operador de encadeamento opcional (?) para evitar erros.

​
Enviando Dados de Vendas

A API oferece duas rotas principais para criar e atualizar pedidos:
  • POST /sales para criar vendas
  • PUT /sales/:transactionId para atualizar vendas
Certifique-se de incluir o header Authorization com seu token de API em todas as requisições.