SendGrid: ligar, trocar e remover a integração — e as telas do aplicativo

Atualizado em 22/10/2026

SENDGRID: LIGAR, TROCAR E REMOVER A INTEGRAÇÃO — E AS TELAS DO APLICATIVO

O QUE VOCÊ ENCONTRA AQUI
Aqui está o detalhe da tela onde a ligação acontece: o campo, o botão, as instruções escritas na própria tela, e por que não existe "editar a chave". A visão geral de "conta no SendGrid, chave de API, informar a chave", as permissões de acesso ao aplicativo e o vínculo por loja com o efeito de remover uma integração são tratados à parte, no conteúdo geral de Integrações.

A TELA DE ADICIONAR INTEGRAÇÃO TEM UM CAMPO SÓ
A tela "Adicionar integração SendGrid" tem um único campo: "Chave: API Key". Ele é obrigatório. O botão "Cadastrar" fica desabilitado enquanto o campo estiver vazio — não é travamento nem falta de permissão, é o campo em branco. Depois de salvar, o sistema mostra a mensagem devolvida pela própria operação; se der erro, a mensagem de erro aparece em caixa de diálogo. Leia essa mensagem antes de qualquer outra coisa: ela é a informação mais direta que você tem.

AS TRÊS INSTRUÇÕES QUE A PRÓPRIA TELA MOSTRA
Abaixo do campo, a tela traz o passo a passo, com o título "Para utilizar o E-mail em massa SendGrid, siga os passos abaixo:". São três:
1. Acessar https://sendgrid.com/ e se cadastrar.
2. Depois do cadastro, no canto esquerdo clicar em "Settings", depois em "API Keys" e, para gerar a chave, clicar em "Create API Key".
3. Copiar a chave gerada e colar no campo acima.
Ressalva importante: "Settings", "API Keys" e "Create API Key" são nomes do site do parceiro, não do ERP. O parceiro pode mudar esses nomes e a posição dos menus a qualquer momento. Se você não encontrar esses itens, procure pelo conceito — a área de configurações da conta e a geração de chave de API — ou fale com o suporte do próprio SendGrid.

A CHAVE É CREDENCIAL: NÃO CIRCULE ELA
A chave de API dá acesso à sua conta. Não envie a chave por chat, e-mail ou qualquer canal de atendimento, e não peça para ninguém "conferir se está igual". Se uma chave chegou a circular em uma conversa, considere-a comprometida: gere uma chave nova no portal do SendGrid e cadastre essa nova no ERP, descartando a antiga.

NÃO EXISTE TELA DE EDITAR A CHAVE: PARA TROCAR, REMOVE E CADASTRA DE NOVO
Este é o ponto que mais gera chamado. O aplicativo tem só duas telas de integração: a tela da integração e a de adicionar. Não existe tela de edição da chave — não é que esteja escondida, ela não existe.
Além disso, quando já existe integração ligada, a tela da integração deixa de oferecer "Adicionar integração" e passa a oferecer "Remover integração".
A tela de adicionar, ao abrir, consulta a situação da integração no servidor e pode devolver você para a tela da integração em vez de mostrar o formulário. Se isso acontecer, é esse mecanismo — não é erro de navegador nem falta de permissão. Em que situações exatas essa devolução acontece depende da resposta do servidor.
Então "só quero trocar a chave" se resolve pelo caminho que existe: remover a integração e cadastrar de novo com a chave nova. Antes de remover, confira o que a remoção implica — isso é tratado no conteúdo geral de Integrações.
Outro detalhe operacional: a remoção acontece no clique. Não existe tela de confirmação entre o botão e o efeito. Tenha certeza antes de clicar.

MENSAGENS QUE CHEGAM PELO LINK
Duas mensagens não nascem do que você faz na tela, e sim do link com que você chegou nela:
"Esta loja não está integrada ao SendGrid." — aparece como aviso quando você chega nessa tela redirecionado de outro ponto do sistema. Ou seja, é um aviso de quem mandou você para essa tela, e não uma verificação que a tela faz. A tela não tem seletor de loja e não pede loja em lugar nenhum, então essa mensagem não quer dizer que a chave seja de uma loja só nem da empresa toda.
Mensagem de erro na chegada — tanto a tela da integração quanto a de adicionar exibem uma notificação de erro quando o link que abriu a tela já traz uma mensagem. O texto varia; leia o que está escrito e trate por ele.

O QUE A TELA DA INTEGRAÇÃO MOSTRA
Título "SendGrid", uma descrição de apresentação, os botões, uma imagem ilustrativa e, sob o título "Realizando esta integração você vai conseguir:", uma lista fechada de cinco itens, sempre esses: envio de e-mails em massa, relatórios de envio, automatização de disparos, melhor entregabilidade e gerenciamento centralizado. É texto de apresentação, não configuração — não há o que marcar ou desmarcar ali. Um desses itens promete mais do que o aplicativo entrega.
Se a consulta de situação falhar, a tela mostra a mensagem de erro em caixa de diálogo e não termina de carregar. Nesse caso o assunto é a mensagem, não o botão.

A TELA INICIAL DO APLICATIVO: QUATRO CARTÕES, LISTA FECHADA
A tela inicial do SendGrid tem quatro cartões, e a lista é fechada — não existe um quinto:
Templates — "Visualize seus templates, que foram cadastrados na SendGrid".
Envios — "Envie emails via SendGrid do nosso sistema."
Configurações — "Configure sua integração com a SendGrid".
Usuários — "Gerencie seu usuários da SendGrid".
Duas coisas que mudam o atendimento:
O cartão Usuários leva ao cadastro de usuários DO SISTEMA. É a mesma tela de usuários do ERP, apenas aberta por dentro do aplicativo. Não é cadastro de usuário dentro do SendGrid, apesar do texto do cartão. Quem gerencia usuários da conta do parceiro é o portal do parceiro. Cadastro de usuário, grupo e permissão são assunto do ERP.
O cartão Configurações aponta para uma tela que não existe no aplicativo. Quem clica cai na página de erro do sistema, com o texto "Oops! Ocorreu algum erro no sistema." e "A página solicitada não foi encontrada no sistema.". É comportamento conhecido, não é falha do navegador nem do login. Configuração de verdade do SendGrid é a chave de API, na tela de integração descrita acima.

O AVISO DE VERSÃO DE DEMONSTRAÇÃO NO TOPO
No topo da tela inicial pode aparecer um aviso que começa com "A versão de demonstração deste aplicativo ..." seguido do prazo ("expira hoje", "expira em X dias", "expirou há X dias") e de um link "Clique aqui para contrata-lo!". O aviso é montado a partir da situação do aplicativo na conta e não aparece quando o aplicativo está vinculado a um plano contratado. Ele aparece em amarelo e passa a vermelho quando o vencimento está próximo ou já passou. Prazo, valor e condição são assunto do comercial.

O REMETENTE NÃO SE ESCOLHE AQUI
Na tela da chave não existe campo de remetente. Quem envia é definido na hora do disparo, na tela "Enviar e-mails". Os campos de remetente, o que vem preenchido neles e a dica que aparece ao lado ficam naquela tela de envio.

O QUE COSTUMA DAR ERRADO
"O botão Cadastrar não clica." O campo da chave está vazio. Ele só habilita com conteúdo no campo.
"Quero trocar a chave e não acho onde editar." Não existe tela de edição. Remova a integração e cadastre de novo.
"Entrei para cadastrar e a tela me jogou para outro lugar." A tela de adicionar consulta a situação da integração ao abrir e pode devolver para a tela da integração. Confira nela se o botão está como "Remover integração" — se estiver, já existe integração ligada.
"Cliquei em Configurações e deu página não encontrada." O cartão aponta para uma tela que não existe no aplicativo. Não há o que corrigir do seu lado.
"Criei um usuário aqui e ele não apareceu no SendGrid." O cartão Usuários é o cadastro de usuários do sistema. Usuário da conta do parceiro se cria no portal do parceiro.
"Colei a chave e deu erro." Leia a mensagem devolvida na tela. Espaço no começo ou no fim ao copiar, chave incompleta e chave revogada são causas comuns de erro em cadastro de chave — quando a mensagem não disser qual é, não dá para cravar a causa. A saída segura é gerar uma chave nova no portal do parceiro e cadastrar a nova — nunca reutilizar chave que circulou em conversa.
"Removi por engano." Cadastre de novo, com uma chave gerada no portal.

O QUE NÃO DÁ PARA GARANTIR
Não dá para afirmar onde a chave fica guardada, nem se ela vale por loja ou pela empresa toda. Também não dá para afirmar que o sistema confere a chave junto ao SendGrid no momento do cadastro, nem o que muda na entrega entre usar o e-mail padrão do sistema e usar o SendGrid próprio.