Messagerie

Rapports de remise et logs

Chaque SMS se termine par un statut final : remis, non remis, expiré ou rejeté. Recevez-le sur un webhook au moment où il arrive, récupérez-le, ou cherchez-le dans vos logs.

Recevoir les rapports sur un webhook

Définissez webhooks.delivery.url sur chaque message. Dès que le statut final est connu, Pulsr l’envoie à cette URL. Ajoutez intermediateReport: true pour recevoir aussi les états intermédiaires.

send.ts

await pulsr("POST", "/sms/3/messages", {  messages: [    {      sender: "YourBrand",      destinations: [{ to: "33639981234", messageId: "order-4821" }],      content: { text: "Your order #4821 has shipped." },      webhooks: {        delivery: { url: "https://yourapp.com/webhooks/pulsr?token=…" },        contentType: "application/json",        // Returned untouched in the report, up to you what goes in it        callbackData: "order=4821",      },    },  ],});

POST vers votre webhook

{  "results": [    {      "bulkId": "2034072219640523072",      "messageId": "order-4821",      "to": "33639981234",      "sender": "YourBrand",      "sentAt": "2026-10-19T09:30:00.000+0000",      "doneAt": "2026-10-19T09:30:03.000+0000",      "messageCount": 1,      "price": { "pricePerMessage": 0.045, "currency": "EUR" },      "status": {        "groupId": 3,        "groupName": "DELIVERED",        "id": 5,        "name": "DELIVERED_TO_HANDSET",        "description": "Message delivered to handset"      },      "error": {        "groupId": 0,        "groupName": "OK",        "id": 0,        "name": "NO_ERROR",        "description": "No Error",        "permanent": false      },      "callbackData": "order=4821"    }  ]}

Traiter le rapport

Mettez à jour vos données à partir de status.groupName et conservez error.name en cas d’échec. Le guide Webhooks explique comment sécuriser l’endpoint et gérer les renvois.

app/webhooks/pulsr/route.ts

export async function POST(req: Request) {  // Check the token first, see the Webhooks guide  const { results } = await req.json();  for (const report of results) {    await db.message.update({      where: { id: report.messageId },      data: {        status: report.status.groupName, // DELIVERED, UNDELIVERABLE, ...        error: report.error.id === 0 ? null : report.error.name,        deliveredAt: report.doneAt,      },    });  }  return new Response(null, { status: 200 });}

Champ	Description
`messageId`	Votre identifiant si vous l’avez défini sur la destination, sinon le nôtre.
`status`	Statut final. Voir Statuts de message.
`error`	La raison de l’échec ; `permanent` indique si réessayer peut servir.
`sentAt`, `doneAt`	Quand le message est parti de Pulsr, et quand le statut final a été atteint.
`messageCount`	Nombre de segments SMS facturés.
`price`	`pricePerMessage` et `currency`.
`callbackData`	La valeur que vous avez envoyée, inchangée.

Récupérer les rapports

GET/sms/3/reports

Pas encore de serveur public ? Récupérez les rapports. Filtrez par bulkId ou messageId, et réglez limit (50 par défaut, 1 000 maximum).

reports.ts

const query = "bulkId=reminders-2026-10-20&limit=100";const { results } = await pulsr("GET", `/sms/3/reports?${query}`);for (const report of results) {  console.log(report.messageId, report.status.name);}

Les logs listent les messages envoyés avec leur statut actuel, et peuvent être consultés autant que nécessaire. Filtrez par destination, sender, bulkId, messageId, generalStatus (par exemple DELIVERED, UNDELIVERABLE) et une plage sentSince / sentUntil. Utilisez useCursor=true et le cursor renvoyé pour paginer les gros résultats.

logs.ts

const params = new URLSearchParams({  destination: "33639981234",  sentSince: "2026-10-19T00:00:00.000+0000",  generalStatus: "UNDELIVERABLE",  limit: "50",});const { results } = await pulsr("GET", `/sms/3/logs?${params}`);