Criando uma nova conta e chave de API

Este processo é utilizado por clientes em processo de recebimento do codigo fonte ou para ex-clientes que já possuem o codigo fonte e querem alterar a conta/Chave de API da Plataforma.

Acesse a Sendgrid e crie uma nova conta.
A conta deve ter uma senha de 16 caracteres e com todos os caracteres (letra maiúscula, caractere especial, numero e leta minúscula).
Caso tenha dificuldades em criar a senha, utilize esse site para gerar uma senha automática: Gerador de senhas | LastPass

Ao acessar a conta criada, localize o campo "Settings" e depois cliente em "API Keys":

Gerando as novas chaves
Clique em "Create API Key".
A 1° chave deverá sem criada em "Full Access", anote a senha pois ao clicar em salvar não será possível visualizar a chave novamente.
Essa chave é responsável pelos envios de e-mails automáticos da plataforma, aqueles que estão em "templates de e-mails".

A 2° chave é "Email Address Validation Access", anote a senha pois ao clicar em salvar não será possível visualizar a chave novamente.

Essa chave é responsável pela validação anti-Spam dos e-mails para garantir que não entre como Spam aos recebedores, essa chave é opcional e é criada apenas em contas pagas na Sendgrid conforme observação abaixo.

Obs.: O campo "Email Address Validation Access" é opcional e não impede o funcionamento da plataforma caso não seja criada.
Essa chave não irá aparecer em contas gratuitas, caso deseje criar essa chave também e garantir que os e-mails não caiam como Spam em alguns casos, será preciso assinar o plano Pro ou Premier da Sendgrid: Sendgrid Pricing Plans

Obs.: Vale ressaltar que contas gratuitas na Sendgrid possuem limite de 100 e-mails por dia:

Reforçamos que a chave mais importante a ser criada é a chave "Full Access", então se você está em fase de recebimento do codigo fonte, você receberá o codigo fonte após a alteração dessa chave "Full Access", e se caso não fornecer a chave "Email Address Validation Access", deixaremos esse campo vazio ("null") na plataforma, e posteriormente você mesmo poderá inserir uma chave, quando em posse do codigo fonte, seguindo o passo ao final desse artigo.

Se você está em fase de entrega do codigo fonte basta informar ao nosso time de Suporte a(s) chave(s), informando juntamente o titulo da(s) chave(s) (Full Access e Email e/ou Address Validation Access).

Após alterar sua chave de API, a Sendgrid exige que os envios de e-mails de sua plataforma sejam a partir de um e-mail autenticado pela sendgrid, que no caso é domínio de sua plataforma.
Para todas as novas contas, o domínio do endereço do remetente usado na integração da API deve sempre usar o domínio autenticado na conta. Isso garantirá que o e-mail esteja alinhado com SPF DKIM para entrega de e-mail perfeita das respectivas contas.
O e-mail deve ser no modelo: "meuemail@seudominio"
Desta forma, insira no painel de customizações um e-mail no modelo acima para garantir os envios de e-mails:

Se você já tem o codigo fonte

1. Na plataforma acesse em Configurações:

Em configurações acesse >> Environment >> smtp

Altere o username e password com o login e senha da sua conta Sendgrid que criou anteriormente.

1. 

2. Em Sendgrid, utilizando as chaves de APIKey criadas, adicione a chave "Full Access" na configuração: sendgridApiKey.

3. Em sendgridApiKeyForEmailValidations insira a chave "Email Address Validation Access":
   Se não houver essa 2º chave insira: null.

Obs.: A 1º chave sendgridApiKey é a chave responsável pelo envio dos e-mails, portanto esse campo não poderá ficar como null.

Autenticação de dominio na Sendgrid

Seu dominio é autenticado pela Ideia no Ar durante a fase de implantação conosco, e não é necessário autenticar novamente se seu e-mail faz envios e recebem e-mails normalmente a partir de seu dominio. Mas se desejar autenticar novamente em caso de troca de plataforma de hospedagem, uma nova conta Sendgrid para gerenciar a autenticação, ou por outro fatores, siga o processo abaixo.

1 - Dentro do menu lateral acessar as opções "Settings >> Sender Authentication":

2 - Selecionar a opção "Authenticate Your Domain":

3 - Selecionar qual a ferramenta de apontamento de DNS foi feito o domínio.

Normalmente nossos clientes usam Cloudflare, então esse processo será realizado com o dominio apontado na Cloudflare, mas se seu dominio está apontado em outra hospedagem é só selecionar sua hospedagem na opção abaixo, e em ultimo caso, se não encontrar sua plataforma de hospedagem, selecione "outros".

Após isso, avance para a próxima fase selecionando "NEXT".

4 - Adicionar seu domínio que será validado (importante conferir no lado direito como ficarão os e-mails enviados com este domínio).

• Esta confirmação vai gerar 3 códigos que devem ser adicionados dentro da ferramenta de apontamento de DNS (no exemplo será o Cloudflare). Importante que todos os códigos sejam copiados.

5 - Acesse sua conta Cloudflare ou outro gerenciador de DNS. Os dados de acesso estão na planilha de contas entregue junto ao codigo fonte, caso não encontre, provavelmente não foi fornecido esse acesso à Ideia no Ar, mas se tiver problemas com esse acesso basta acionar o suporte da Ideia no Ar.

Selecionar a opção de "DNS"

Ir adicionando 1 a 1 os códigos de validação informados pelo Sendgrid.

Selecionado o tipo como "CNAME" e colando os respectivos códigos de validação na mesma sequencia informada pela Cloudflare.

Proxy status: DNS only.

Após o processo no Cloudflare, deve aguardar alguns instantes e solicitar a validação dentro do Sendgrid. O resultado da validação deve retornar verde; se houver erros, verifique se os registros foram corretamente configurados no painel de DNS e persista na configuração até ter tudo verde.

Após isso seu dominio estará autenticado.