Référence : Codes d'événements

Cette page liste tous les codes d'événements utilisés dans les logs et les webhooks SendAs.me.

Statuts d'envoi d'email

Ces codes apparaissent dans le champ status des logs d'emails (portail et API) et dans le champ event des webhooks.

Code	Signification	Action recommandée
`sent`	L'email a été accepté et délivré par Gmail ou Office 365	Aucune — l'envoi est réussi
`failed_temp`	L'envoi a échoué temporairement (erreur réseau, API indisponible, quota momentané)	Automatiquement retenté par SendAs.me
`failed_perm`	L'envoi a échoué définitivement (adresse invalide, compte révoqué, quota dépassé de façon permanente)	Intervenir manuellement — ne sera pas retenté

Ces codes apparaissent dans le champ event des payloads de webhook.

Événement	Déclenché quand	Données incluses
`email_sent`	Un email a été envoyé avec succès	`log_id`, `from_address`, `to_address`, `subject`, `provider`, `message_id`
`email_failed_temp`	Un envoi a échoué temporairement	`log_id`, `from_address`, `to_address`, `subject`, `provider`, `error`, `retry_count`, `next_retry_at`
`email_failed_perm`	Un envoi a échoué définitivement	`log_id`, `from_address`, `to_address`, `subject`, `provider`, `error`, `final: true`

Événement	Déclenché quand	Données incluses
`oauth_connected`	Un utilisateur final a connecté son compte Gmail ou Office 365	`credential_id`, `email`, `provider`
`oauth_expired`	Le compte d'un utilisateur ne peut plus être utilisé (révocation ou expiration non récupérable)	`credential_id`, `email`, `provider`, `reason`

Valeur	Description
`refresh_token_revoked`	L'utilisateur a révoqué l'accès depuis son compte Google ou Microsoft
`refresh_token_expired`	Le jeton de rafraîchissement a expiré (cas rare, certains comptes Microsoft)
`account_disabled`	Le compte Google ou Microsoft de l'utilisateur a été désactivé
`insufficient_scope`	Les permissions accordées ne sont plus suffisantes

Valeur	Fournisseur
`gmail`	Compte Google (Gmail personnel ou Google Workspace)
`microsoft`	Compte Microsoft (Office 365 personnel ou Azure Active Directory)

Ces codes sont retournés à votre application lorsqu'une connexion SMTP échoue.

Code SMTP	Message	Cause probable
`535`	Authentication failed	Identifiant ou mot de passe incorrect
`550`	From address not authorized	L'adresse `From:` ne correspond à aucun compte OAuth connecté
`550`	OAuth account revoked	Le compte OAuth de l'utilisateur a été révoqué
`452`	Insufficient system storage	Quota de l'API fournisseur atteint
`421`	Service temporarily unavailable	Erreur temporaire, réessayez dans quelques instants

Ces statuts sont visibles dans le portail (section Utilisateurs connectés) et dans les réponses de l'API.

Statut	Description	Emails possibles
`active`	Compte connecté, jeton valide	Oui
`expired`	Jeton d'accès expiré, en cours de rafraîchissement automatique	Oui (rafraîchissement transparent)
`revoked`	L'utilisateur a révoqué l'accès	Non — reconnexion nécessaire
`error`	Erreur lors du dernier rafraîchissement	Non — vérification manuelle conseillée

Statut	Description
`pending`	Livraison en attente (première tentative non encore effectuée)
`delivered`	Livraison réussie (code HTTP 2xx reçu)
`failed`	Toutes les tentatives ont échoué
`retrying`	Tentatives en cours (entre deux retries)