Nível de Dificuldade: Iniciante
Este guia completo mostra o passo a passo para gerar um novo token de acesso na sua conta do Melhor Envio e inseri-lo corretamente no local exato do plugin no seu site wordpress com woocommerce.
Pré-requisitos: #
- Ter uma conta ativa no Melhor Envio.
- Ter um site wordpress com woocommerce instalado e ativo.
- Ter o plugin Melhor Envio para woocommerce instalado e ativo.
Parte 1: Gerando o Token no Painel do Melhor Envio #
Nesta etapa, vamos criar a chave de API (o token) dentro da sua conta do Melhor Envio.
Passo 1: Acesse sua Conta Melhor Envio
- Acesse o site: https://melhorenvio.com.br/
- Faça o login com seu e-mail e senha.
Passo 2: Navegue até as Permissões de Acesso
- No menu lateral esquerdo, clique em “Integrações”.
- No submenu que se abre, clique em “Permissões de Acesso”.
Passo 3: Inicie a Geração do Token
- Na página “Permissões de Acesso”, clique no botão “GERAR NOVO TOKEN”.
Passo 4: Aceite os Termos, Configure e Dê Permissões ao Token
- Na primeira tela, leia as condições de uso, marque a caixa
Li e aceito as condiçõese clique em “Avançar”. - Na tela seguinte, configure seu token:
- Nome do Token: Dê um nome fácil de identificar, como
Token Loja woocommerce. - Permissões: Abaixo do nome, você verá uma lista de permissões. É crucial que você marque todas as caixas de seleção para garantir o funcionamento completo do plugin (cálculo de frete, geração de etiquetas, etc.).
- Nome do Token: Dê um nome fácil de identificar, como
- Após nomear e selecionar todas as permissões, clique em “Gerar Token”.
Passo 5: Copie o Token Gerado
- O token será gerado e exibido na tela.
- ATENÇÃO: Este é o único momento em que o token completo será exibido. Por segurança, ele não ficará visível novamente.
- Clique no ícone de copiar ao lado do token para garantir que o copiou corretamente. Cole-o temporariamente em um local seguro (como o Bloco de Notas).
Parte 2: Inserindo o Token no Plugin do wordpress #
Com o token em mãos, vamos inseri-lo no painel do seu site wordpress.
Passo 6: Acesse o Painel do wordpress
- Faça login na área administrativa do seu site (geralmente em
seusite.com.br/wp-admin).
Passo 7: Acesse a Página de Configuração do Token
- No menu lateral esquerdo do painel do wordpress, procure e clique no item de menu principal “Melhor Envio”.
- No submenu que se abre, clique em “Token”.
Passo 8: Cole o Token no Campo Correto
- Você será levado diretamente para a página de configuração do token.
- No campo “Token”, cole a chave que você copiou no Passo 5. Tenha certeza de que não há espaços em branco antes ou depois do código.
Passo 9: Salve as Alterações
- Clique no botão “Salvar” para confirmar e ativar a integração.
Verificação e Solução de Problemas (FAQ) #
- P: As opções de frete do Melhor Envio pararam de funcionar de repente. O que fazer?
- R: Se a integração estava funcionando e parou, o motivo mais provável é que seu token expirou ou foi invalidado. Siga estes passos para verificar:
- No seu painel wordpress, vá para Melhor Envio > Configurações.
- Procure no topo da página por uma mensagem de aviso. Ela pode ser difícil de enxergar, pois costuma ser um texto branco sobre um fundo cinza-claro.
- A mensagem dirá algo como: “Seu Token Melhor Envio expirou, cadastre um novo token para o plugin voltar a funcionar perfeitamente”.
- Se encontrar essa mensagem, seu token expirou. Você precisa gerar um novo token seguindo a Parte 1 deste tutorial e inseri-lo novamente (Parte 2).
- R: Se a integração estava funcionando e parou, o motivo mais provável é que seu token expirou ou foi invalidado. Siga estes passos para verificar:
- P: Configurei tudo, mas o frete não aparece para o cliente. O que pode ser?
- R: Se a verificação de token expirado acima não se aplica, confira estes pontos:
- Token/Permissões: Ao gerar um novo token, confirme que você marcou todas as permissões (Passo 4).
- Dimensões e Peso: Certifique-se de que seus produtos no woocommerce têm peso e dimensões (altura, largura, comprimento) cadastrados. Sem isso, o cálculo não funciona.
- CEP de Origem: Verifique se o CEP de origem da sua loja está configurado corretamente em Melhor Envio > Configurações.
- R: Se a verificação de token expirado acima não se aplica, confira estes pontos:
- P: Perdi o token que gerei. E agora?
- R: Não é possível recuperá-lo. Volte ao painel do Melhor Envio (Integrações > Permissões de Acesso), localize o token antigo na lista e clique no ícone de lixeira para revogá-lo. Em seguida, gere um novo token seguindo este tutorial.

