Voici @honkio/node, notre SDK Node.js (ah, et HonkIO reçoit maintenant des courriels)

Nous avons un nouveau SDK Node.js à vous présenter, et c'est le clou de ce billet. Il y a une autre petite chose à la fin. Essayez de ne pas sauter à la conclusion.

@honkio/node

@honkio/node est le client Node.js officiel de HonkIO, maintenant sur npm. Il fonctionne avec Node 18 ou plus récent, en ESM comme en CommonJS, et n'a aucune dépendance à l'exécution.

npm install @honkio/node

Chaque appel renvoie { data, error }, et une erreur de l'API ne lève jamais d'exception. error.name est le code de l'API, comme NON_CANADIAN_NUMBER, ou network_error quand aucune réponse n'est arrivée : une seule condition couvre donc chaque échec.

import { Honkio } from '@honkio/node'

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

const { data, error } = await honkio.messages.send({
  from: '+1416XXXXXXX',
  to: '+1613XXXXXXX',
  body: 'Your table is ready.',
})

if (error) console.error(error.name, error.message) // e.g. NON_CANADIAN_NUMBER
else console.log(data.id, data.status)

Il couvre toute l'API, sur les deux canaux :

• SMS : messages, numéros de téléphone (recherche, activation, libération) et codes de vérification
• Consentements LCAP pour les numéros de téléphone et les adresses courriel
• Courriel : envois, envois groupés, programmation, modèles enregistrés avec versions, domaines d'envoi et suppressions
• Webhooks : points de terminaison, vérification des signatures, rotation du secret, journaux de livraison et relance des lettres mortes

Vous écrivez les champs de requête en camelCase et recevez la réponse de l'API telle qu'elle a été envoyée. Le guide, à honkio.ca/fr/docs/sdk, présente chaque ressource avec des exemples.

MCP 1.9.0

La version 1.9.0 de @honkio/mcp est aussi sur npm, avec 64 outils. Le point d'accès hébergé à mcp.honkio.ca est déjà à jour, et npx récupère la nouvelle version au prochain démarrage de votre agent.

Ah, avons-nous oublié de parler de la réception des courriels?

Nous avons peut-être gardé le meilleur pour la fin. HonkIO reçoit maintenant des courriels, lui aussi.

Chaque compte a une adresse de réception gérée, sans rien à configurer : pas de DNS, pas de domaine, et n'importe quelle partie locale fonctionne. Demandez-la à l'API, puis récupérez chaque message à son arrivée :

const { data: address } = await honkio.emails.received.address()
console.log(address.example) // anything@<your-slug>.inbound.honkio.ca

// In your email.received webhook handler: the event carries metadata only
const { data: email } = await honkio.emails.received.get(event.data.email.id)
console.log(email.from, email.subject, email.verdicts)

Pour recevoir plutôt à votre propre domaine, vérifiez-le pour l'envoi, activez la réception et publiez l'unique enregistrement MX que l'API renvoie. Un sous-domaine est recommandé, pour que le reste de votre configuration de courriel reste tel quel. Le webhook email.received ne transporte que des métadonnées, jamais le corps : récupérez le message complet par son identifiant. Chaque message arrive avec des verdicts SPF, DKIM, DMARC et pourriel, et des pièces jointes que vous pouvez télécharger.

• Chaque message reçu coûte 0,0025 $ CAD, comme un envoi, pour son premier Mo, puis 0,002 $ par Mo entamé. Le courriel bloqué comme virus est gratuit
• Le courriel reçu est stocké au Canada, à Montréal (ca-central-1), comme le reste de votre compte
• Le corps du message est conservé 90 jours; le message brut et ses pièces jointes, 40 jours
• Chaque compte reçoit jusqu'à 1 000 courriels par jour par défaut; le courriel au-delà du plafond n'est pas facturé
• La réception réelle exige que le téléphone du titulaire du compte soit vérifié, comme pour l'envoi réel. Les clés de test peuvent simuler du courriel reçu, gratuitement

Le guide de réception, à honkio.ca/fr/docs/email#receiving, couvre les domaines, les verdicts, les pièces jointes et le webhook. Si vous comparez HonkIO à un fournisseur de courriel américain, la page honkio.ca/fr/compare/us-email-providers explique ce qui change.