SMS

Les canaux SMS permettent à un utilisateur d’effectuer un signalement sans application mobile et sans connexion Internet.

Ils sont conçus pour offrir une expérience simplifiée, rapide et accessible à tous les utilisateurs, même dans les zones à faible connectivité.

La plateforme permet de :

• créer un signalement via SMS
• suivre l’évolution du traitement d’un signalement via SMS
• maintenir une conversation structurée par session SMS
• finaliser automatiquement un signalement à partir des échanges SMS

---

Signalement via SMS

Cette API permet à un utilisateur d’interagir avec la plateforme via SMS afin de créer ou compléter un signalement.

Chaque échange SMS est traité dans une session de conversation permettant de guider l’utilisateur jusqu’à la constitution complète du signalement.

Endpoint : POST /reports/by-sms-channel

Headers requis :

Content-Type: application/json
Accept: application/json

Paramètres de requête :

Paramètre	Type	Requis	Description
sender_phone_number	string	Oui	Numéro de téléphone de l’utilisateur
content	string	Oui	Message SMS envoyé par l’utilisateur

Requête :

curl -X POST "https://clients-api-services.mazone-test.ansut.ci/api/v1.0/reports/by-sms-channel" \
  -H "Content-Type: application/json" \
  -d '{
    "sender_phone_number": "+2250700000000",
    "content": "Pas de réseau dans ma zone"
  }'

Réponse succès (200) :

{
  "error": false,
  "message": "Successfully",
  "data": {
    "chat_session_id": "8f1c2d3a-xxxx-xxxx-xxxx-xxxxxxxx"
  }
}

Comportement métier (SMS)

Lors de l’envoi d’un SMS :

• vérification de l’existence de l’utilisateur
• création ou récupération d’une session SMS active
• ajout du message dans l’historique de conversation
• gestion de l’expiration de session (5 minutes)
• génération d’une réponse automatique ou guidée
• déclenchement éventuel de la création du signalement

---

Conversation SMS

Chaque utilisateur interagit avec la plateforme via une session de conversation SMS.

Cette session permet de :

• conserver l’historique des échanges
• guider l’utilisateur étape par étape
• enrichir progressivement les informations du signalement
• finaliser la création du signalement lorsque les données sont complètes

Endpoint : GET /reports/by-sms-channel/{chat_session_id}/conversation

Headers requis :

Content-Type: application/json
Accept: application/json

Paramètres de requête :

Paramètre	Type	Requis	Description
chat_session_id	string	Oui	Identifiant de la session SMS

Requête :

curl -X POST "curl -X GET "https://clients-api-services.mazone-test.ansut.ci/api/v1.0/reports/by-sms-channel/8f1c2d3a-xxxx-xxxx-xxxx-xxxxxxxx/conversation"" \
  -H "Content-Type: application/json" \

Réponse succès (200) :

{
  "error": false,
  "message": "Successfully",
  "data": [
    {
      "from": "user",
      "content": "Pas de réseau dans ma zone",
      "created_at": "2026-05-11 16:10:00"
    },
    {
      "from": "ai",
      "content": "Pouvez-vous préciser votre localisation ?",
      "created_at": "2026-05-11 16:10:05"
    }
  ]
}

Comportement métier (SMS)

Lors de l’envoi d’un SMS :

• vérification de l’existence de la session SMS
• récupération de l’historique complet des échanges
• tri chronologique des messages
• retour de la conversation structurée