Jèko Texto (SMS)

Jèko Texto permet à un marchand abonné de consulter ses soldes de messages, par canal, et d'envoyer des SMS depuis la Partner API. Le solde WhatsApp est visible, mais l'envoi n'accepte que channel: "sms".

Prérequis

Le service s'active sur demande auprès de Jèko, qui ouvre votre compte de messages et le crédite en unités. Tant que ce compte n'existe pas, toutes les routes /partner_api/messages répondent 403 messages_not_subscribed.

Si votre compte existe mais que l'envoi de SMS n'est pas encore activé, l'envoi répond 403 message_sms_provider_not_configured et aucune unité n'est débitée. Contactez Jèko pour finaliser l'activation.

Consulter les soldes

GET /partner_api/messages/account renvoie smsBalance et whatsappBalance, le nombre d'unités restantes sur chaque canal.

Envoyer un SMS

POST /partner_api/messages avec :

• channel : "sms" (obligatoire ; "whatsapp" est refusé avec une erreur de validation 422)
• to : numéro du destinataire au format international, avec l'indicatif pays précédé de + (par exemple +2250701020304)
• body : de 1 à 1600 caractères
• reference : de 1 à 255 caractères, unique pour votre entreprise

Chaque envoi réussi débite une unité SMS. Réutiliser une reference renvoie le message d'origine (200) sans second débit, y compris quand la première tentative s'est terminée en failed.

Si l'envoi échoue définitivement après la réservation de l'unité, Jèko recrédite l'unité, passe le message en status: "failed" et répond tout de même 200 avec ce message.

Si smsBalance vaut 0, l'envoi répond 403 insufficient_message_balance sans rien envoyer.

Lister et consulter les messages

GET /partner_api/messages est paginé (page, limit) et accepte un filtre channel facultatif (sms ou whatsapp). Les résultats ne concernent que votre entreprise, du plus récent au plus ancien.

GET /partner_api/messages/{id} renvoie un message de votre entreprise. L'identifiant d'un message d'une autre entreprise renvoie 404 message_not_found.