Melhor Envio
Cotar fretes, comprar, gerar, imprimir e cancelar etiquetas e consultar o rastreamento pelo Melhor Envio.
O que faz
Cuide dos fretes da sua loja: cote entre CEPs, crie, compre, gere e imprima etiquetas, cancele quando precisar e responda "cadê meu pedido?" com o status atualizado da entrega.
Quando usar: Use quando o seu fluxo precisar cotar fretes, comprar, gerar, imprimir e cancelar etiquetas e consultar o rastreamento pelo Melhor Envio.
Exemplo de situação: Consultar um pedido ou executar uma ação comercial durante o atendimento.
Antes de começar
Conexão necessária: Conexão do workspace ou do canal.
Confirme que a integração ou o canal já está conectado no workspace.
Passo a passo
- Adicione Melhor Envio ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Confirme que a integração ou o canal já está conectado no workspace.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Rastrear Pedido | Rastreia Pedido com o bloco Melhor Envio. |
| Buscar Envios do Cliente | Busca Envios do Cliente com o bloco Melhor Envio. |
| Cotar Frete | Cota Frete com o bloco Melhor Envio. |
| Listar Envios | Lista Envios com o bloco Melhor Envio. |
| Criar Etiqueta (carrinho) | Cria Etiqueta (carrinho) com o bloco Melhor Envio. |
| Comprar Etiqueta | Compra Etiqueta com o bloco Melhor Envio. |
| Gerar Etiqueta | Gera Etiqueta com o bloco Melhor Envio. |
| Imprimir Etiqueta | Imprime Etiqueta com o bloco Melhor Envio. |
| Cancelar Etiqueta | Cancela Etiqueta com o bloco Melhor Envio. |
| Listar Serviços | Lista Serviços com o bloco Melhor Envio. |
| Listar Agências | Lista Agências com o bloco Melhor Envio. |
| Status da Conexão | Executa a operação “Status da Conexão” com o bloco Melhor Envio. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Rastrear Pedido · Buscar Envios do Cliente · Cotar Frete · Listar Envios · Criar Etiqueta (carrinho) · Comprar Etiqueta · Gerar Etiqueta · Imprimir Etiqueta · Cancelar Etiqueta · Listar Serviços · Listar Agências · Status da Conexão
- Exemplo:
- Rastrear Pedido
Conta Melhor Envio
Usa a conta do Melhor Envio conectada no workspace. Os tokens de acesso nunca são expostos a este bloco nem ao agente.
- Exemplo:
- (escolha na lista do campo)
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <melhorenvio.response>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<melhorenvio.response> | json | Resposta da API v2 do Melhor Envio para a operação executada. |
Exemplo de uso
Objetivo: Consultar um pedido ou executar uma ação comercial durante o atendimento.
- Operação
- Rastrear Pedido
- Conta Melhor Envio
- (escolha na lista do campo)
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <melhorenvio.response>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- AsaasGerar cobranças Pix, boletos, links e assinaturas, consultar pagamentos e reenviar dados sem duplicar cobranças.
- Bling ERPConsultar estoque, movimentar saldo, administrar pedidos, notas fiscais e clientes no Bling ERP.
- CatálogoMostrar o catálogo ou um produto do WhatsApp Business (Z-API) dentro de um fluxo de conversa.
- NuvemshopConsultar a loja, recuperar carrinhos, criar cupons e administrar produtos, pedidos e clientes na Nuvemshop.
- PIXEnviar pelo WhatsApp (Z-API) um botão que copia a chave PIX.
- Recuperar carrinhoAcompanhar um carrinho abandonado no CRM e enviar recuperação opcional sem repetir mensagens; o pagamento confirmado encerra o negócio como ganho.