Emails

Lister les conversations email

Retourne la liste paginée des threads email du client (cursor v2). Tri stable last_message_at DESC, id DESC — les conversations avec un échange récent en premier. last_message_at est NOT NULL côté table.

Lecture seule

L'API publique expose seulement la liste des threads. Le détail des messages individuels d'une conversation n'est pas encore exposé via l'API publique — le payload se limite aux métadonnées du thread. Pour envoyer un email, utiliser POST /v1/emails/send.

curl -X GET 'https://app.capturia.io/api/v1/emails/conversations' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json'

Envoyer un email transactionnel

Met en queue un email transactionnel pour livraison via Resend. L'email est créé avec status="queued", priority=1, type="transactional" et délivré de manière asynchrone par le worker email — la réponse 201 confirme la mise en queue, pas la délivrance finale.

Expéditeur résolu serveur-side

L'expéditeur (from) est dérivé du sender par défaut du client (client_email_senders.is_default = true). Si aucun sender par défaut n'est configuré, la requête retourne 400 no_sender_configured.

Idempotency

Le header Idempotency-Key n'est PAS supporté sur cette route — un retry naïf créera un second envoi. Une clé d'idempotence interne est générée serveur-side (api-transactional/{clientId}/{ts}) pour protéger uniquement contre les doubles inserts en base.

Mode test

"test": true dans le body permet de valider une intégration sans viser un vrai contact : les variables de personnalisation sont interpolées avec des valeurs d'exemple, le sujet est préfixé [TEST], et les vérifications de conformité destinataire sont contournées. En contrepartie, le destinataire doit être un membre actif de l'équipe du client (sinon 400 recipient_not_allowed) et un quota de 50 tests / 24 h glissantes s'applique, partagé avec les boutons de test de la plateforme (sinon 429 test_quota_exceeded).

curl -X POST 'https://app.capturia.io/api/v1/emails/send' \
  -H 'Authorization: Bearer cap_live_<your-key>' \
  -H 'Content-Type: application/json' \
  -d '{
  "to": "[email protected]",
  "subject": "Confirmation de votre commande",
  "body": "<p>Bonjour Alex,</p><p>Votre commande est confirmée.</p>"
}'