Fonctionnalités

SMS et courriel pour le Canada, dans une seule API

Deux produits sur un seul compte : des SMS vers et depuis des numéros de mobile canadiens, et des courriels envoyés et reçus sur votre propre domaine. La LCAP et la LPRPDE sont appliquées au niveau de l'API, et vos données sont stockées au Canada, à Montréal (ca-central-1).

Commencer gratuitement Voir la documentation API

SMS

Des SMS bidirectionnels vers les mobiles canadiens, depuis des numéros canadiens que vous provisionnez par l'API.

SMS sortant: Envoyez vers n'importe quel numéro de mobile canadien au format E.164.
SMS entrant: Recevez des messages entrants via webhook. Fils de réponse inclus.
Mode test: Validez les messages sans les envoyer. Messages de test illimités.
Clés d'idempotence: Envoyez un en-tête Idempotency-Key sur chaque requête susceptible d’être réessayée : la même clé renvoie le message d’origine au lieu d’envoyer et de facturer de nouveau.
Accusés de livraison: Statut en temps réel : en file → envoyé → livré ou échoué.
Historique des messages: Recherchez et filtrez les messages envoyés par date, numéro ou statut.
Numéros de téléphone canadiens: Des numéros locaux dans toutes les provinces et des numéros sans frais partout au Canada (SMS après vérification), provisionnés par l’API en quelques secondes.
Vérification téléphonique (OTP): Envoyez un code à usage unique et vérifiez-le : deux appels. Les codes expirent après 10 minutes.

Courriel

Du courriel sur votre propre domaine, dans les deux sens : reçus, réinitialisations de mot de passe et avis à l’envoi, et les réponses au retour. Un courriel commercial ne part qu'avec un consentement LCAP au dossier.

Transactionnel par défaut: Reçus, réinitialisations et avis partent sans formalités de consentement. Marquez un courriel comme commercial et HonkIO exige un consentement LCAP au dossier, ajoute le pied de désabonnement et respecte le désabonnement en un clic.
Votre propre domaine: DKIM et adresse de retour sur votre domaine, vérifiés en quelques minutes. Rien ne change dans la configuration courriel de votre domaine racine.
Une adresse de réception, prête tout de suite: Chaque compte reçoit une adresse de réception gérée, sans rien à configurer, et n’importe quel nom avant le @ y parvient. Chaque message arrive par un webhook email.received; récupérez le contenu, les pièces jointes et les verdicts SPF, DKIM, DMARC et pourriel par son id.
Réception sur votre propre domaine: Activez la réception sur un domaine dont vous envoyez déjà et publiez un seul enregistrement MX; un sous-domaine laisse vos boîtes principales où elles sont. Le courriel reçu est stocké au Canada : le contenu pendant 90 jours, le message brut et les pièces jointes pendant 40.
Modèles versionnés: Stockez des modèles avec des variables déclarées. Les modifications sont enregistrées en brouillon, la publication crée une version numérotée, et un retour en arrière se fait en un appel.
Lots et programmation: Jusqu'à 100 courriels par appel en lot. Programmez un envoi jusqu'à 30 jours à l'avance, puis déplacez-le ou annulez-le tant qu'il attend. L'annulation rembourse les frais.
Un mode test fidèle au réel: Envoyez depuis une adresse bac à sable vers des destinataires spéciaux et voyez livraisons, rebonds et plaintes arriver en webhooks, avant de toucher au DNS.
Suppression et suspension automatique: Les rebonds définitifs et les plaintes pour pourriel ajoutent l'adresse à votre liste de suppression, et plus aucun courriel n'y est envoyé; un désabonnement bloque seulement les courriels commerciaux. Si vos courriels récents en direct rebondissent ou suscitent des plaintes à un taux élevé, l'envoi en direct est suspendu 24 heures et un webhook vous en donne la raison.

Les deux canaux

Ce que les SMS et les courriels ont en commun : un seul compte, les mêmes règles de conformité et un seul endroit où vos données sont stockées.

Stocké au Canada: Les SMS, les données de courriel, les consentements et les listes de suppression sont stockés au Canada, à Montréal (ca-central-1). Une seule réponse sur la résidence des données couvre les deux canaux.
La LCAP sur les deux canaux: Le consentement est enregistré une fois par numéro de téléphone ou adresse courriel. Un envoi commercial sans consentement au dossier est refusé avant toute facturation.
SMS et courriel sur un seul compte: Un seul solde prépayé en CAD, un seul jeu de clés API, un seul flux de webhooks pour les deux canaux.
Un seul flux de webhooks: Chaque événement SMS et courriel, de la livraison au rebond, à l'ouverture ou au désabonnement, arrive signé HMAC sur les mêmes points de terminaison et est réessayé avec recul exponentiel.
Serveur MCP et SDK Node: Laissez Claude, Cursor ou Copilot envoyer des SMS et des courriels par le serveur MCP de HonkIO, ou appelez les deux canaux depuis @honkio/node.
Clés en direct et de test: Un seul jeu de clés pour les deux canaux, avec des permissions limitées, et une clé peut être restreinte à certains domaines d'envoi. Les clés de test n'envoient rien et ne facturent rien.
Journal d'audit et limites de débit: Chaque action sur une clé et chaque événement de conformité est journalisé de façon immuable, et chaque compte a ses propres limites de débit.
Effacement en un appel: Conçu pour la LPRPDE et la Loi 25 du Québec : effacez les données d’un numéro de téléphone en un seul appel API, et le contenu des courriels est purgé de lui-même après 90 jours.

Gestion du consentement LCAP

Suivi du consentement: Enregistrez le consentement exprès et tacite avec piste d'audit complète.
Désinscription automatique: Les mots-clés STOP/STOPALL/UNSUBSCRIBE/QUIT/END/CANCEL et ARRÊT/ARRET sont traités automatiquement.
Expiration du consentement: Le consentement tacite expire automatiquement après 2 ans conformément à la LCAP §10(9).
Vérification LNNTE (à venir): La vérification automatisée de la liste nationale de numéros exclus du CRTC avant les envois de télémarketing arrive bientôt.
Blocage HTTP 451: Les envois non conformes sont rejetés avec le code de statut légalement approprié.
Droit à l'effacement: Effacez le contenu des messages et supprimez les dossiers de consentement, de vérification et de contact pour un numéro de téléphone ; le désabonnement LCAP lui-même est conservé.

Webhooks et accusés de livraison

Abonnements aux événements: SMS : message.queued, message.sending, message.sent, message.delivered, message.failed, message.undelivered, message.received. Courriel : email.queued, email.sent, email.delivered, email.delivery_delayed, email.bounced, email.complained, email.rejected, email.failed, email.opened, email.clicked, email.unsubscribed, email.cancelled, email.rescheduled, email.received, email_domain.verified, email_domain.verification_failed, email_domain.receiving_verified, email_domain.receiving_failed. Compte : opt_out.recorded, opt_out.reinstated, consent.double_opt_in_confirmed, account.delivery_warning, account.sending_paused, account.spend_warning, account.inbound_email_capped, account.auto_topup_succeeded, account.auto_topup_paused, phone_number.suspended, phone_number.released, toll_free_verification.changes_requested, toll_free_verification.approved, toll_free_verification.rejected.
Signatures HMAC: Chaque charge utile de webhook est signée avec votre secret de compte. Vérifiez l'authenticité.
Logique de réessai: Les livraisons de webhook échouées sont réessayées avec recul exponentiel.
Endpoints multiples: Enregistrez plusieurs URLs de webhook par type d'événement.
Journaux de livraison: Inspectez toutes les tentatives de livraison de webhook dans votre tableau de bord.
Rejeu des lettres mortes: Rejouez tout événement ayant épuisé ses trois tentatives de livraison, ou supprimez-le, depuis votre tableau de bord ou l’API.

Authentification et sécurité

Types de clés API: Clés de production (mk_live_...) et clés de test (mk_test_...) par compte.
Clés limitées: Émettez des clés en envoi seulement, lecture seulement ou portée admin.
Révocation de clé: Faites pivoter ou révoquez les clés à tout moment sans interruption.
Limitation de débit: Limites de débit par compte avec algorithme de fenêtre glissante.
Journal d'audit: Chaque action de clé et événement de conformité est enregistré de façon immuable.
Résidence des données canadiennes: Toutes les données d’authentification sont stockées au Canada (ca-central-1).

API REST axée développeurs

Spec OpenAPI: Spec OpenAPI 3.1 complète disponible pour la génération de code.
Erreurs bilingues: Tous les messages d'erreur retournés en EN et FR (Accept-Language).
Erreurs structurées: Format d'erreur uniforme avec les champs code, message et détails.
Swagger UI: Explorateur API interactif (Swagger UI) à api.honkio.ca/docs.
REST idiomatique: Méthodes HTTP standard, codes de statut et pagination.
Compatible curl: Conçu pour être suffisamment simple à tester avec curl et un jeton Bearer.
Serveur MCP pour agents IA: Laissez Claude, Cursor ou Copilot envoyer des SMS, vérifier des numéros et contrôler le consentement LCAP directement. Publié sur npm, sans SDK à brancher.

Numéros de téléphone canadiens

Recherche de numéros: Recherchez les numéros canadiens disponibles par indicatif régional ou province.
Provisionnement instantané: Provisionnez un numéro via l'API en quelques secondes. Actif immédiatement.
Libération de numéros: Libérez les numéros dont vous n'avez plus besoin. La facturation s'arrête immédiatement.
Canada seulement: Seuls les indicatifs régionaux canadiens sont acceptés. Plus de 60 codes NPA validés.
Comptes multi-numéros: Provisionnez autant de numéros que votre plan le permet.
Codes courts: Campagnes de codes courts (5-6 chiffres) disponibles sur demande.

Vérification de numéro de téléphone (NPU)

NPU par SMS: Envoyez un code à usage unique à tout numéro canadien. Longueur configurable de 4 à 8 chiffres.
Point de contrôle: Soumettez le code pour confirmer. La réponse retourne le statut vérifié et les tentatives restantes.
Expiration et limite de tentatives: Les codes expirent après 10 minutes. 5 tentatives avant verrouillage.
Mode test inclus: En mode test, le code est toujours des zéros (ex. 000000). Aucun SMS envoyé.
Journal d’audit: Toutes les demandes de vérification et leurs résultats sont consignés de manière immuable.
API en deux étapes simple: POST /verify pour démarrer, POST /verify/{id}/check pour confirmer. C’est tout.

Commencez à envoyer des SMS et des courriels conformes au Canada

Créer un compte gratuit

Les clés de test fonctionnent sans carte. Lire la documentation API →