Perché ricevo l’errore 403 unverified_workspace_recipient?

Questo articolo spiega l’errore 403 Workspace not verified che ricevono i nuovi workspace quando inviano a indirizzi esterni, e come rimuovere la limitazione.

Sintomi

POST /v2/emails restituisce 403 con un corpo come questo:

{
  "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"]
}

Potresti vedere anche:

• L’SMTP rifiuta il destinatario con 550 Unverified workspaces can only send to workspace members' account emails.
• Le campagne non riescono con Unverified workspaces cannot send campaigns.
• Il pannello mostra il banner This workspace is not verified. Emails can only be sent to workspace members’ account emails.

Causa

Ogni nuovo workspace parte non verificato, in una sandbox. Finché il team di Emailit non approva l’accesso alla produzione per il workspace:

• Puoi inviare solo agli indirizzi email degli account dei membri del workspace, cioè gli indirizzi con cui le persone accedono. Gli inviti in attesa non contano.
• Se un indirizzo in to, cc o bcc non è in quell’elenco, l’intera richiesta viene rifiutata e non vengono addebitati crediti. L’array blocked_recipients elenca gli indirizzi che l’hanno causato.
• Le campagne non si possono inviare affatto.

Questo protegge la reputazione di invio condivisa dagli abusi da parte di account appena creati.

Soluzione

1. Verifica un dominio di invio. L’accesso alla produzione richiede almeno un dominio verificato. Aggiungine uno in Email API›Domains e pubblica i suoi record. Vedi Aggiungi un dominio.

2. Apri il modulo di richiesta. Seleziona Request production access nel banner del pannello, oppure vai a Workspace›Settings, apri Requests e scegli Request Workspace Verification. Solo gli amministratori del workspace possono inviarla.

3. Descrivi i tuoi invii in modo onesto. Scegli il tipo di email (Transactional, Marketing o entrambi), indica l’URL del sito, il volume mensile previsto e il caso d’uso, spiega come raccogli i destinatari e spunta le caselle di conformità. Le risposte precise vengono approvate più in fretta.

4. Segui la conversazione della richiesta. La richiesta risulta Pending Review mentre il team la esamina. Se passa a Awaiting Your Reply, rispondi alla domanda nella conversazione. Quando risulta Approved, la limitazione viene rimossa subito.

5. Nel frattempo continua a fare prove. Invia all’email del tuo account, oppure invita colleghi in modo che i loro indirizzi diventino consentiti dopo che hanno accettato l’invito. Vedi Come provo l’invio prima che il workspace sia verificato?.

Leggi Accesso alla produzione per l’intera procedura di revisione ed Errori dell’API per le altre risposte 403.

Serve ancora aiuto?

Se la richiesta è in attesa da un po’, rispondi nella conversazione della richiesta, contatta il supporto o chiedi su Discord.