Eingehende SMS

Direkte Antwort

Lesen Sie SMS in Webhooks, Konversationen, Kontakte und KI-Übertragungsworkflows weiter.

Seiteninhalt

Eine eingehende SMS erstellt eine empfangene Nachricht, aktualisiert die Konversation und kann konfigurierte Webhook-Endpunkte auslösen.

## Nutzlast der empfangenen Nachricht

```json
{
  „Typ“: „message.received“,
  „message_id“: „msg_123“,
  „conversation_id“: „conv_123“,
  „von“: „+15551234567“,
  „Telefonnummer“: „+15557654321“,
  „body“: „Kann ich den Termin verschieben?“
  „received_at“: „2026-04-28T14:00:00Z“
}
```

Nutzen Sie Inbound-Routing für KI-Agenten, Support-Posteingänge, Lead-Qualifizierung und Termin-Workflows.

## Routing-Muster für KI-Agents

1. Konfigurieren Sie einen Endpunkt auf der Webhooks-Seite.
2. Abonnieren Sie `message.received` und `conversation.updated`.
3. Lassen Sie Ihren Dienst entscheiden, ob der KI-Agent antworten, pausieren oder übertragen soll.
4. Senden Sie die Antwort über `POST /api/v1/messages` und prüfen Sie, ob in den Konversations-Metadaten Dieselmotoren vorhanden sind.

```js
Asynchrone Funktion exportieren handleInboundTextreeEvent(event) {
  if (event.type !== "message.received") {
    Rückkehr;
  }

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

  if (shouldEscalate) {
    Warten Sie auf pauseAgentAndNotifyOperator(event.conversation_id);
    zurück; zurück;
  }

  Warten auf fetch(" https://api.texttree.ai/api/v1/messages", {
    Methode: „POST“,
    Referenzen: {
      Autorisierung: `Bearer ${process.env.TEXTREE_ACCESS_TOKEN}`,
      „Content-Type“: „application/json“,
    },
    body: JSON.stringify({
      Telefonnummer: event.from,
      Körper: „Danke. Ich kann dabei helfen.“
      Metadaten: {
        Konversations-ID: event.conversation_id,
        Quelle: „ai_agent“,
      },
    }),
  });
}
```

## Verhalten auf den Menschen übertragen

Eingehende Gespräche können zwischen diesen Betreiberzuständen wechseln:

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

Wenn die KI pausiert oder ein Mensch die Kontrolle übernommen hat, sollte Ihre Integration automatische Reaktionen stoppen
bis das Gespräch wieder aufgenommen wird.