SMS

Démarrage rapide SMS

Envoyez votre premier SMS canadien en moins de 5 minutes.

L’authentification, les clés API, la configuration et la signature des webhooks, les limites de débit, le SDK, le serveur MCP et les codes d’erreur généraux se trouvent sur la page Plateforme.

Démarrage rapide

Créer un compte gratuit, puis ouvrez Clés API → Créer la clé dans le tableau de bord. La clé complète ne s’affiche qu’une fois, juste après sa création : copiez-la à ce moment.
Commencez par une clé de test : elle fonctionne immédiatement, avant toute recharge, pour envoyer des messages de test et explorer l’API gratuitement.
Rechargez votre solde par carte via Stripe. Les clés de production retournent 402 PAYMENT_REQUIRED jusqu’à la première recharge.
Vérifiez votre numéro de téléphone en tant que propriétaire du compte. Un envoi réel nécessite un numéro de propriétaire vérifié.
Achetez un numéro canadien pour l’envoi ; un envoi réel nécessite un numéro appartenant à votre compte.
Enregistrez le consentement LCAP pour chaque numéro de téléphone que vous allez contacter.
Envoyez votre premier message via l’API REST.

Envoyez votre premier message

Avec une clé, un numéro et le consentement en place, un seul appel envoie le SMS. Le SDK Node.js et l’API REST prennent les mêmes champs.

import { Honkio } from '@honkio/node'

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

// "from" is one of your HonkIO numbers; "to" is a real number you hold consent for
const { data, error } = await honkio.messages.send({
  from: '+1416XXXXXXX',
  to: '+1613XXXXXXX',
  body: 'Hello from HonkIO! 🇨🇦',
})
if (error) throw new Error(`${error.name}: ${error.message}`)
console.log(data.id, data.status)

import os

from honkio import Honkio

client = Honkio(os.environ["HONKIO_API_KEY"])

# "from_" is one of your HonkIO numbers; "to" is a real number you hold consent for
message = client.messages.send(
    from_="+1416XXXXXXX",
    to="+1613XXXXXXX",
    body="Hello from HonkIO! 🇨🇦",
)
print(message["id"], message["status"])

<?php

use Honkio\Honkio;

$honkio = new Honkio(getenv('HONKIO_API_KEY'));

// "from" is one of your HonkIO numbers; "to" is a real number you hold consent for
$message = $honkio->messages->send([
    'from' => '+1416XXXXXXX',
    'to' => '+1613XXXXXXX',
    'body' => 'Hello from HonkIO! 🇨🇦',
]);
echo $message['id'], ' ', $message['status'], "\n";

# "from" is one of your HonkIO numbers; "to" is a real number you hold consent for
curl -X POST https://api.honkio.ca/v1/messages \
  -H "Authorization: Bearer mk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "+1416XXXXXXX",
    "to":   "+1613XXXXXXX",
    "body": "Hello from HonkIO! 🇨🇦"
  }'

Consultez la référence du SDK pour un client typé avec chaque ressource et la vérification des webhooks.