# 8.7 Mensagens do widget

> As mensagens que o widget mostra quando o CEP é inválido, quando não há frete para ele ou quando a consulta falha, e o que fazer para o cliente não ficar sem saída.

Fonte: https://www.cotafrete.app/manual/widgets-da-loja/mensagens-personalizadas/
Planos: Widget, Basic, Business
No app: Widgets da loja → Widget de cotação
Atualizado em 25/10/2026

---

Nem toda consulta de frete termina com uma lista de opções. Às vezes o CEP foi digitado errado. Às vezes nenhuma opção sobra para aquele destino. O que o cliente lê nesse momento decide se ele vai embora sem entender ou se sabe o que fazer em seguida.

## As mensagens

O widget tem três mensagens, com texto fixo:

| Mensagem | Quando aparece |
|---|---|
| "Por favor, insira um CEP válido." | O que foi digitado não tem o formato de um CEP (8 dígitos) |
| "CEP de destino inexistente." | A consulta terminou sem nenhuma opção de frete para o CEP |
| "Erro ao consultar o frete. Tente novamente." | A consulta falhou no caminho (rede, tempo esgotado) |

Os textos não são editáveis na tela Widgets da loja. Dá para mudar a aparência delas pelo **CSS personalizado**, com a classe `.cotafrete-error` (veja [Personalizar o widget](https://www.cotafrete.app/manual/widgets-da-loja/personalizar-o-widget/#css-personalizado)).

## "CEP de destino inexistente" nem sempre quer dizer isso

A segunda mensagem aparece sempre que a lista volta vazia, por qualquer motivo:

- o CEP realmente não existe;
- uma [regra de bloqueio](https://www.cotafrete.app/manual/regras-de-frete/bloquear/) tirou todas as opções daquele destino;
- nenhuma transportadora ativa atende aquele CEP, ou o peso do pedido passou do limite de todas;
- nenhum serviço do Cota Frete está ligado no perfil de entrega da Shopify em que o produto está.

Por isso, quando um cliente reclama dessa mensagem com um CEP válido, a investigação começa pela configuração, não pelo CEP. O [Simular frete](https://www.cotafrete.app/manual/inicio/simular-frete/) mostra, para o produto e o CEP do cliente, o que cada ponto da loja devolve.

## Para o cliente não ficar sem saída

Se uma região aparece muito sem frete, a melhor resposta é ter uma opção, não um texto melhor. Algumas saídas:

- manter uma transportadora que atenda a faixa, por exemplo os [Correios](https://www.cotafrete.app/manual/transportadoras/correios/), que chegam a CEPs onde as transportadoras privadas não chegam;
- criar um serviço de [Fretes Próprios](https://www.cotafrete.app/manual/fretes-proprios/entrega-local/), como retirada na loja, para a região;
- revisar as [regras de bloqueio](https://www.cotafrete.app/manual/regras-de-frete/bloquear/) que cobrem aquele CEP.

Se a loja não atende uma região de propósito, diga isso perto do widget, no texto da página do produto ou nas políticas de entrega, para o cliente não interpretar a mensagem como defeito.

## No checkout

No checkout, quem controla a tela é a Shopify. Quando nenhuma opção de frete existe para um endereço, o checkout mostra o aviso padrão dela, sem texto do app.

Veja também [Uma transportadora não cota para um CEP](https://www.cotafrete.app/manual/solucao-de-problemas/transportadora-nao-cota-cep/).