Messagerie

Recevoir des SMS

Quand quelqu’un écrit à l’un de vos numéros, Pulsr transmet le message à votre webhook en quelques secondes : réponses, confirmations et désinscriptions arrivent dans votre produit.

Configurer un numéro

01Dans le tableau de bord, ouvrez Numéros et prenez un numéro compatible SMS bidirectionnel dans votre pays.
02Dans les réglages du numéro, indiquez l’URL du webhook entrant, par exemple https://yourapp.com/webhooks/inbound?token=….
03Si besoin, ajoutez des mots-clés (comme STOP ou JOIN). Le premier mot du message est reconnu et renvoyé à part.

Ce que vous recevez

POST vers votre webhook

{  "results": [    {      "messageId": "817790313235066447",      "from": "33639981234",      "to": "33644630000",      "text": "STOP",      "cleanText": "",      "keyword": "STOP",      "receivedAt": "2026-10-19T09:41:00.000+0000",      "smsCount": 1,      "price": { "pricePerMessage": 0, "currency": "EUR" },      "callbackData": null    }  ],  "messageCount": 1,  "pendingMessageCount": 0}

Champ	Description
`from`	Le numéro de l’expéditeur. C’est à lui que vous répondez.
`to`	Votre numéro qui a reçu le message.
`text`	Le message complet.
`keyword`, `cleanText`	Le mot-clé reconnu, et le texte sans lui.
`receivedAt`	Quand Pulsr l’a reçu.
`smsCount`	Le nombre de segments du message.

Traiter et répondre

Répondez depuis le numéro qui a reçu le message : la conversation reste dans un seul fil sur le téléphone de la personne.

app/webhooks/inbound/route.ts

import { pulsr } from "@/lib/client";export async function POST(req: Request) {  // Check the token first, see the Webhooks guide  const { results } = await req.json();  for (const sms of results) {    if (sms.keyword === "STOP") {      await db.contact.optOut(sms.from);      continue;    }    // Answer from the number they wrote to    await pulsr("POST", "/sms/3/messages", {      messages: [{        sender: sms.to,        destinations: [{ to: sms.from }],        content: { text: "Thanks, we will reply within the hour." },      }],    });  }  return new Response(null, { status: 200 });}

Récupérer plutôt que recevoir

GET/sms/1/inbox/reports

Les numéros sans URL de webhook conservent les messages entrants pour que vous les récupériez. Chaque message n’est renvoyé qu’une fois ; pendingMessageCount indique combien attendent encore.

inbox.ts

const inbox = await pulsr("GET", "/sms/1/inbox/reports?limit=100");const { results, pendingMessageCount } = inbox;for (const sms of results) {  console.log(sms.from, sms.text);}// pendingMessageCount > 0 means there is more to fetch

Configurer un numéro

01Dans le tableau de bord, ouvrez Numéros et prenez un numéro compatible SMS bidirectionnel dans votre pays.
02Dans les réglages du numéro, indiquez l’URL du webhook entrant, par exemple https://yourapp.com/webhooks/inbound?token=….
03Si besoin, ajoutez des mots-clés (comme STOP ou JOIN). Le premier mot du message est reconnu et renvoyé à part.

Ce que vous recevez

POST vers votre webhook

{  "results": [    {      "messageId": "817790313235066447",      "from": "33639981234",      "to": "33644630000",      "text": "STOP",      "cleanText": "",      "keyword": "STOP",      "receivedAt": "2026-10-19T09:41:00.000+0000",      "smsCount": 1,      "price": { "pricePerMessage": 0, "currency": "EUR" },      "callbackData": null    }  ],  "messageCount": 1,  "pendingMessageCount": 0}

Champ	Description
`from`	Le numéro de l’expéditeur. C’est à lui que vous répondez.
`to`	Votre numéro qui a reçu le message.
`text`	Le message complet.
`keyword`, `cleanText`	Le mot-clé reconnu, et le texte sans lui.
`receivedAt`	Quand Pulsr l’a reçu.
`smsCount`	Le nombre de segments du message.

Traiter et répondre

Répondez depuis le numéro qui a reçu le message : la conversation reste dans un seul fil sur le téléphone de la personne.

app/webhooks/inbound/route.ts

import { pulsr } from "@/lib/client";export async function POST(req: Request) {  // Check the token first, see the Webhooks guide  const { results } = await req.json();  for (const sms of results) {    if (sms.keyword === "STOP") {      await db.contact.optOut(sms.from);      continue;    }    // Answer from the number they wrote to    await pulsr("POST", "/sms/3/messages", {      messages: [{        sender: sms.to,        destinations: [{ to: sms.from }],        content: { text: "Thanks, we will reply within the hour." },      }],    });  }  return new Response(null, { status: 200 });}

Récupérer plutôt que recevoir

GET/sms/1/inbox/reports

inbox.ts

const inbox = await pulsr("GET", "/sms/1/inbox/reports?limit=100");const { results, pendingMessageCount } = inbox;for (const sms of results) {  console.log(sms.from, sms.text);}// pendingMessageCount > 0 means there is more to fetch