SMS entrant

Réponse directe

Achemine le SMS entrant vers des webhooks, des conversations, des contacts et des workflows de transfert d'IA.

Contenu source

Un SMS entrant crée un message reçu, met à jour la conversation et peut déclencher les points de terminaison du webhook configurés.

## Charge utile du message reçu

```json
{
"type": "message.reçu",
"message_id": "msg_123",
"conversation_id": "conv_123",
"de": "+15551234567",
"numéro_téléphone": "+15557654321",
"body": "Puis-je reprogrammer ?"
"reçu_at": "2026-04-28T14:00:00Z"
}
```

Utilisez le routage entrant pour les agents IA, les boîtes de réception d'assistance, la qualification des leads et les workflows de rendez-vous.

## Modèle de routage pour les agents IA

1. Configurez un point de terminaison sur la page Webhooks.
2. Abonnez-vous à `message.received` et `conversation.updated`.
3. Demandez à votre service de décider si l'agent IA doit répondre, mettre en pause ou transférer.
4. Envoyez la réponse via `POST /api/v1/messages` en utilisant les mêmes métadonnées de conversation.

```js
exporter la fonction asynchrone handleInboundTextreeEvent(event) {
if (event.type !== "message.received") {
retour;
  }

const ShouldEscalate = event.body.toLowerCase().includes("human");

si (devrait escalader) {
wait pauseAgentAndNotifyOperator(event.conversation_id);
retour;
  }

attendre récupérer("https://api.texttree.ai/api/v1/messages", {
méthode : "POST",
en-têtes : {
Autorisation : `Bearer ${process.env.TEXTREE_ACCESS_TOKEN}`,
"Content-Type": "application/json",
    },
corps : JSON.stringify({
numéro_téléphone : événement.from,
body : "Merci. Je peux vous aider.",
métadonnées : {
conversation_id : event.conversation_id,
source : "ai_agent",
      },
    }),
  });
}
```

## Transférer le comportement aux humains

Les conversations entrantes peuvent se déplacer entre ces états d'opérateur :

-`AI active`
-`Human takeover`
-`Paused`
-`Resolved`

Lorsque l'IA est suspendue ou qu'un humain prend le contrôle, votre intégration doit arrêter les réponses automatisées
jusqu'à ce que la conversation reprenne.