Test et production, maintenant pour le consentement aussi

Chaque compte HonkIO a deux sortes de clés d'API. Les clés de production (mk_live_...) envoient de vrais messages et puisent dans votre solde. Les clés de test (mk_test_...) simulent les envois : vous pouvez développer et lancer vos tests sans texter personne ni payer quoi que ce soit. Le tableau de bord fonctionne de la même façon : un seul sélecteur Production/Test en haut, que suit chaque page qui a un mode. Les nouveaux comptes commencent en Test, pour que les premiers clics ne coûtent jamais rien.

Ce qui change : les consentements ont un mode

Jusqu'ici, les consentements et les désabonnements étaient communs aux deux modes. Un consentement enregistré avec une clé de test comptait aussi pour les envois de production, et une suite de tests qui faisait le ménage en révoquant des consentements pouvait bloquer des envois de production. Chaque fiche appartient désormais au mode qui l'a créée :

• Clé de test ou sélecteur en Test : vous ne voyez et ne modifiez que les fiches de test, et les envois de test sont vérifiés par rapport à elles
• Clé de production ou sélecteur en Production : vous ne voyez et ne modifiez que les fiches de production, et les envois de production sont vérifiés par rapport à elles
• Téléversements de consentements en lot : chaque téléversement appartient au mode dans lequel il a été fait
• Réponses de vrais téléphones : STOP et START sont toujours en production, tout comme un désabonnement depuis un courriel de production

Vos envois de production n'exigent rien de vous. Toutes les fiches que vous aviez déjà sont maintenant des fiches de production, donc les messages de production sont vérifiés exactement comme hier. Seuls les envois de test méritent un coup d'œil : un envoi de test commercial exige maintenant un consentement enregistré avec votre clé de test. Si vos tests envoient des messages commerciaux, enregistrez d'abord le consentement avec la clé de test.

Où le sélecteur s'applique

• Messages : le journal affiche le mode où vous êtes, et un envoi de test est simulé et gratuit
• Vérification : en Test, le code est toujours fait de zéros et aucun texto n'est envoyé
• Courriel : votre boîte d'envoi et votre boîte de réception suivent le sélecteur, et les envois de test sont simulés
• Conformité : consentements, désabonnements et téléversements, comme décrit plus haut
• Applications Auth : les applications de test et de production sont distinctes, chacune avec ses utilisateurs et ses réglages
• Clés d'API et bac à sable : vous voyez et utilisez les clés du mode où vous êtes

Ce qui reste partagé

• Votre solde et la facturation : il y a un seul solde, et un envoi de test n'y touche jamais
• Numéros de téléphone : en acheter un est un vrai achat dans les deux modes, et le tableau de bord le précise en Test
• Contacts, groupes et listes : communs aux deux modes pour l'instant
• Suppressions de courriel dues aux rebonds et aux plaintes : communes, donc un rebond en production arrête aussi les envois de test à cette adresse

Pour les développeurs

Les réponses des consentements, des désabonnements et des téléversements portent maintenant un champ livemode, le même que celui des événements de webhook. Chaque appel porte sur les fiches de la clé qui le fait, donc une vérification faite avec une clé de production ignore les fiches de test :

# Recorded with a test key, so it counts for test sends only
curl -X POST https://api.honkio.ca/v1/compliance/consents \
  -H "Authorization: Bearer mk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number": "+14165550142", "consent_type": "express", "source_description": "Signup form, test run"}'

# A live key does not see it
curl "https://api.honkio.ca/v1/compliance/consents/check?phone_number=%2B14165550142" \
  -H "Authorization: Bearer mk_live_YOUR_KEY"

{
  "phone_number": "+14165550142",
  "allowed": false,
  "reason": "NO_CONSENT",
  "livemode": true
}

Les règles se trouvent sur la page sur le consentement SMS et la page sur la conformité des courriels, dans la section sur les fiches de test et de production.