Blogue

HonkIO envoie maintenant des courriels, sur le compte que vous avez déjà

Des courriels transactionnels depuis votre propre domaine, avec la LCAP intégrée, des données stockées au Canada et des tarifs en CAD : 0,002 $ par destinataire. Le même compte, les mêmes clés API et le même solde que vos SMS.

HonkIO a commencé comme une API SMS pour les expéditeurs canadiens. À partir d'aujourd'hui, elle envoie aussi des courriels : reçus, réinitialisations de mot de passe, alertes et avis de compte, depuis votre propre domaine, sur le compte que vous utilisez déjà pour vos SMS.

Ce qui faisait l'intérêt du côté SMS s'applique tel quel. Vos données sont stockées au Canada, l'API applique la LCAP au lieu de s'en remettre à une liste de vérification, et vous payez en dollars canadiens à même le même solde prépayé.

Stockées au Canada

Les courriels sont envoyés depuis Montréal (ca-central-1), et vos données de courriel sont stockées au Canada avec le reste des données de votre compte. Les vérifications de consentement, les événements de livraison et les listes de suppression sont stockés dans la même région. Une fois parti pour être livré, un courriel se rend au serveur de messagerie du destinataire, où qu'il se trouve; la politique de confidentialité en dit plus sur la façon dont HonkIO traite vos données.

La LCAP, intégrée

Un courriel est transactionnel par défaut, et un courriel transactionnel n'exige aucun consentement enregistré. Marquez un courriel comme commercial et trois choses changent :

  • Il va à un seul destinataire, et il est refusé avec HTTP 451 à moins qu'un consentement LCAP soit au dossier pour cette adresse
  • HonkIO ajoute un pied de page de désabonnement et un en-tête de désabonnement en un clic que les logiciels de courriel respectent
  • Un désabonnement met fin aux courriels commerciaux vers cette adresse, mais les reçus et les réinitialisations de mot de passe continuent de s'y rendre

Les rebonds définitifs et les plaintes pour pourriel ajoutent automatiquement l'adresse à votre liste de suppression : une adresse morte ou mécontente cesse de recevoir des courriels sans que vous ayez à programmer cette logique. Voici comment l'API applique la LCAP ; ce n'est pas un avis juridique sur vos propres messages.

Un compte, une facture

Un courriel coûte 0,002 $ CAD par destinataire, soit 2,00 $ par 1 000, pièces jointes incluses. Le montant est prélevé sur le même solde prépayé que vos SMS, sans frais mensuels : un mois tranquille ne coûte que ce que vous envoyez. Chaque destinataire accepté est facturé une fois, qu'il soit en À, en Cc ou en Cci, et un destinataire refusé par le contrôle de conformité n'est pas facturé.

Les mêmes clés API servent aux deux canaux, et les événements de courriel arrivent dans le même flux de webhooks signés que ceux des SMS. Si vous comparez HonkIO à un fournisseur de courriel américain, la page honkio.ca/fr/compare/us-email-providers explique ce qui change, et quand un fournisseur américain reste le meilleur choix.

Essayer avant de toucher au DNS

Les clés de test n'envoient rien et ne facturent rien, mais elles font les mêmes vérifications et déclenchent les mêmes webhooks qu'une clé réelle. Envoyez depuis onboarding@test.honkio.ca vers delivered@, bounced@, complained@ ou delayed@test.honkio.ca et regardez chaque résultat arriver, avant même d'avoir configuré un domaine.

Les modèles enregistrés, le SDK @honkio/node et notre serveur MCP sont de la partie. Les modèles se modifient en brouillon et se publient en versions numérotées, que vous pouvez restaurer. Les 15 outils courriel du serveur MCP apparaissent pour les comptes où le courriel est activé : un agent peut donc envoyer un courriel, vérifier un domaine ou consulter une suppression comme il le fait déjà pour les SMS.

Envoyer votre premier courriel

Ajoutez un domaine ou un sous-domaine que vous contrôlez, publiez les enregistrements DNS que l'API renvoie (une clé DKIM, et un chemin de retour sur un sous-domaine send.), puis demandez à HonkIO de les vérifier :

sh
curl -X POST https://api.honkio.ca/v1/email-domains \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "mail.acme.ca" }'

# Publish the returned records at your DNS host, then check them:
curl -X POST https://api.honkio.ca/v1/email-domains/DOMAIN_ID/verify \
  -H "Authorization: Bearer mk_live_YOUR_KEY"
# → { "status": "verified", "verified": true, "missing": [] }

Une fois le domaine vérifié, envoyez depuis n'importe quelle adresse de ce domaine avec une clé de production. Avec curl :

sh
curl -X POST https://api.honkio.ca/v1/emails \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme Receipts <receipts@mail.acme.ca>",
    "to": "ada@example.com",
    "subject": "Your receipt for order 1042",
    "html": "<p>Thanks for your order.</p>"
  }'
# Response 201: { "id": "cm...", "status": "queued", "scheduled_at": null }

Ou avec le SDK Node, où chaque appel renvoie data ou error au lieu de lever une exception :

ts
import { Honkio } from '@honkio/node'

const honkio = new Honkio(process.env.HONKIO_API_KEY)

const { data, error } = await honkio.emails.send({
  from: 'Acme Receipts <receipts@mail.acme.ca>',
  to: 'ada@example.com',
  subject: 'Your receipt for order 1042',
  html: '<p>Thanks for your order.</p>',
})

if (error) console.error(error.name, error.message)
else console.log(data.id)

La documentation courriel, à honkio.ca/fr/docs/email, couvre les envois groupés, la programmation, les pièces jointes, les modèles, les webhooks et chaque code d'erreur, ainsi qu'un guide de migration si vous déplacez une intégration existante.

Envoyez votre premier message cet après-midi.