Por que recebo o erro 403 unverified_workspace_recipient?

Este artigo explica o erro 403 Workspace not verified que os workspaces novos recebem ao enviar para endereços externos e como remover a restrição.

Sintomas

POST /v2/emails retorna 403 com um corpo como este:

{
  "code": "unverified_workspace_recipient",
  "error": "Workspace not verified",
  "message": "Unverified workspaces can only send to workspace members' account emails. Blocked recipient: ada@example.com.",
  "blocked_recipients": ["ada@example.com"]
}

Você também pode ver:

• O SMTP rejeita o destinatário com 550 Unverified workspaces can only send to workspace members' account emails.
• As campanhas falham com Unverified workspaces cannot send campaigns.
• O painel mostra o banner This workspace is not verified. Emails can only be sent to workspace members’ account emails.

Causa

Todo workspace novo começa não verificado, em um sandbox. Até a equipe do Emailit aprovar o acesso de produção do workspace:

• Você só pode enviar para os endereços de e-mail das contas dos membros do workspace, ou seja, os endereços que as pessoas usam para fazer login. Convites pendentes não contam.
• Se algum endereço em to, cc ou bcc estiver fora dessa lista, a requisição inteira é rejeitada e nenhum crédito é cobrado. O array blocked_recipients lista os endereços que causaram a rejeição.
• As campanhas não podem ser enviadas de forma alguma.

Isso protege a reputação de envio compartilhada contra abusos de contas recém-criadas.

Solução

1. Verifique um domínio de envio. O acesso de produção exige pelo menos um domínio verificado. Adicione um em Email API›Domains e publique os registros dele. Consulte Adicionar um domínio.

2. Abra o formulário de solicitação. Selecione Request production access no banner do painel ou acesse Workspace›Settings, abra Requests e escolha Request Workspace Verification. Apenas administradores do workspace podem enviar a solicitação.

3. Descreva os seus envios com honestidade. Escolha o tipo de e-mail (Transactional, Marketing ou ambos), informe a URL do seu site, o volume mensal esperado e o caso de uso, explique como você obtém os destinatários e marque as caixas de conformidade. Respostas específicas são aprovadas mais rápido.

4. Acompanhe a conversa da solicitação. A solicitação mostra Pending Review enquanto a equipe a analisa. Se ela mudar para Awaiting Your Reply, responda à pergunta na conversa. Quando ela estiver como Approved, a restrição é removida na hora.

5. Continue testando enquanto isso. Envie para o e-mail da sua própria conta ou convide colegas, para que os endereços deles passem a ser permitidos quando aceitarem o convite. Consulte Como testar o envio antes de o meu workspace ser verificado?.

Leia Acesso de produção para conhecer o processo de análise completo e Erros da API para outras respostas 403.

Ainda com problemas?

Se a sua solicitação estiver pendente há algum tempo, responda na conversa da solicitação, fale com o suporte ou pergunte no Discord.