# Messages aux clients > Les e-mails et les messages Telegram et WhatsApp qu'Abuna a envoyés à vos clients. Source : https://abuna.app/docs/api/notices?hl=fr Listez les messages qu'Abuna envoie à vos clients, comme les reçus et les rappels, et vérifiez que chacun est bien parti. Dans l'API, un message au client est un `notice`. Chaque notice est un message sur un canal : e-mail, Telegram ou WhatsApp. ## L'objet notice **Attributs** - `id` (string): Identifiant unique du message. - `customer_id` (string): Le client à qui le message est destiné. - `subscription_id` (string, nullable): L'abonnement concerné par le message. - `kind` (string): Ce sur quoi porte le message :`subscription_started` : un nouvel abonnement, avec un lien pour payer sa première période. Envoyé 30 minutes après la création de l'abonnement, et seulement si le client n'a pas payé à ce moment-là.`subscription_renewed` : un renouvellement à payer, envoyé au début de sa période.`renewal_upcoming` : une période payée se termine bientôt. Envoyé quand la facture du renouvellement part avant la fin, avec son lien de paiement. Avec `renewal_lead_days` à 0 ou un passage programmé à une formule moins chère, envoyé 3 jours avant la fin, sans lien de paiement.`payment_overdue` : une période est toujours impayée.`payment_final_notice` : le dernier rappel avant la résiliation d'un abonnement impayé.`payment_received` : un reçu. Quand le paiement met en vigueur une montée de formule, il indique aussi l'ancienne et la nouvelle formule. Pour une facture [marquée payée](https://abuna.app/docs/api/invoices-and-payments.md?hl=fr#mark-paid), il indique que vous avez enregistré le paiement.`payment_failed` : un paiement a échoué après que le client a quitté la page de paiement. Au plus un par heure pour chaque facture.`subscription_cancel_scheduled` : une résiliation à la fin de la période payée a été programmée. Il donne la date de fin et indique comment garder l'abonnement.`subscription_cancel_undone` : une résiliation programmée a été retirée, donc l'abonnement continue.`subscription_canceled` : l'abonnement a pris fin.`plan_change_offered` : vous avez proposé un changement de formule au client. Il renvoie vers la page où il l'accepte.`plan_switch_requested` : le client a choisi, sur une page d'abonnement, un autre prix du produit auquel il est abonné. Il renvoie vers la page où il confirme le changement. Il part uniquement par e-mail.`plan_upgraded` : une montée de formule a pris effet sans paiement préalable : rien n'était dû, ou la nouvelle période est à payer via le lien de paiement qu'il donne. Il donne la nouvelle formule et la nouvelle date de facturation.`plan_upgrade_due` : une montée de formule attend que le client paie. Il donne le montant, la date limite de paiement et le lien de paiement.`plan_downgrade_scheduled` : un passage à une formule moins chère a été programmé. Il donne la nouvelle formule et la date à laquelle elle commence.`plan_downgrade_undone` : un passage programmé à une formule moins chère a été retiré, donc la formule se renouvelle telle quelle.`price_change_scheduled` : un prix que le client paie change. Il donne le nouveau montant et la date à laquelle il s'applique pour la première fois à lui.`price_change_canceled` : un changement de prix programmé a été retiré ou remplacé, donc le client continue de payer ce qu'il paie actuellement.`trial_email_code` : le client a choisi de démarrer un essai gratuit sur la page d'abonnement. Il part uniquement par e-mail, avec le code à 6 chiffres qui confirme son e-mail et démarre l'essai.`email_code` : le client a demandé à changer son e-mail dans son espace client. Il va uniquement à la nouvelle adresse, avec le code à 6 chiffres qui la confirme.`contact_changed` : le client a changé son e-mail ou son numéro de téléphone dans son espace client. Il va à l'ancienne adresse e-mail et à la conversation Telegram connectée, avec la nouvelle adresse en partie masquée.`portal_links` : le client a demandé des liens vers ses abonnements. - `channel` (string): `email`, `telegram` ou `whatsapp`. Chaque message part par e-mail. Un client qui a choisi Telegram ou WhatsApp le reçoit aussi là. WhatsApp est désactivé par défaut ; vous l'activez, et une application en production doit être au forfait Plus ou supérieur. - `recipient` (string): L'adresse e-mail ou le numéro WhatsApp auxquels il va. Vide pour Telegram, afin de garder la conversation du client privée. - `subject` (string): La ligne d'objet. - `status` (string): `pending` pendant qu'il attend d'être envoyé, `sending` pendant qu'Abuna l'envoie, `sent`, ou `failed`. `withdrawn` quand il a cessé d'être vrai avant de partir, comme un rappel pour une période qui a été payée, ou un message Telegram ou WhatsApp à un client qui a déconnecté la conversation. - `attempts` (integer): Combien de fois Abuna a essayé de l'envoyer. - `last_error` (string, nullable): Pourquoi la dernière tentative a échoué, ou pourquoi le message a été retiré. - `next_attempt_at` (timestamp): Quand Abuna essaiera de l'envoyer à nouveau, tant qu'il est `pending`. - `created_at` (timestamp): Quand le message a été créé, en secondes Unix. - `sent_at` (timestamp, nullable): Quand il a été envoyé. **L'objet notice** ```json { "id": "e7JpT4cN", "customer_id": "Cu5tM8rA", "subscription_id": "x9QbL2sK", "kind": "payment_received", "channel": "email", "recipient": "jane@example.com", "subject": "Receipt from My store: FCFA 5,000 paid", "status": "sent", "attempts": 1, "last_error": null, "next_attempt_at": 1727600100, "created_at": 1727600100, "sent_at": 1727600102 } ``` ## Lister les messages aux clients `GET /v1/apps/{appID}/notices` Liste les messages aux clients de l'application, du plus récent au plus ancien, une page à la fois. **Paramètres de requête** - `subscription_id` (string): Renvoie uniquement les messages concernant cet abonnement. - `status` (string): Renvoie uniquement les messages avec ce statut : `pending`, `sending`, `sent`, `failed` ou `withdrawn`. - `limit` (integer): Combien de messages renvoyer, de 1 à 100. Par défaut : 50. - `cursor` (string): La valeur `next_cursor` de la page précédente. Envoyez les mêmes filtres avec. > **Remarque :** Une application Test n'envoie que ses codes par e-mail, donc en Test cette liste ne contient que des messages `trial_email_code` et `email_code`. Chaque message, envoyé ou non, apparaît aussi comme un événement [`notification.captured`](https://abuna.app/docs/api/events.md?hl=fr#notification-captured). Renvoie `items` et `next_cursor`, comme décrit dans [Listes et filtres](https://abuna.app/docs/lists-and-filters.md?hl=fr#pages). Une valeur non autorisée, comme un `limit` supérieur à 100, renvoie `422` avec le code `invalid` et le nom du paramètre dans `errors`. **GET /v1/apps/{appID}/notices** cURL : ```bash curl "https://api.abuna.app/v1/apps/8ddhXCDW/notices?subscription_id=x9QbL2sK" \ -H "Authorization: Bearer sk_test_..." ``` Node.js : ```javascript const response = await fetch("https://api.abuna.app/v1/apps/8ddhXCDW/notices?subscription_id=x9QbL2sK", { headers: { Authorization: "Bearer sk_test_..." }, }); const page = await response.json(); ``` Python : ```python import requests response = requests.get( "https://api.abuna.app/v1/apps/8ddhXCDW/notices?subscription_id=x9QbL2sK", headers={"Authorization": "Bearer sk_test_..."}, ) page = response.json() ``` PHP : ```php ["Authorization: Bearer sk_test_..."], CURLOPT_RETURNTRANSFER => true, ]); $page = json_decode(curl_exec($ch), true); ``` Go : ```go req, _ := http.NewRequest("GET", "https://api.abuna.app/v1/apps/8ddhXCDW/notices?subscription_id=x9QbL2sK", nil) req.Header.Set("Authorization", "Bearer sk_test_...") res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var page map[string]any json.NewDecoder(res.Body).Decode(&page) ``` **Réponse** ```json { "items": [ { "id": "e7JpT4cN", "customer_id": "Cu5tM8rA", "subscription_id": "x9QbL2sK", "kind": "payment_received", "channel": "email", "recipient": "jane@example.com", "subject": "Receipt from My store: FCFA 5,000 paid", "status": "sent", "attempts": 1, "last_error": null, "next_attempt_at": 1727600100, "created_at": 1727600100, "sent_at": 1727600102 } ], "next_cursor": null } ```