> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS

> SMS-Nachrichten aus Agenten und Workflows in telli senden

<Frame>
  <video src="https://migthzpcwvipwgioldfr.supabase.co/storage/v1/object/public/public_assets/changelog/2026-06-01-week-23/sms.mp4" width="3842" height="2160" controls muted autoPlay loop playsInline className="w-full rounded-xl" />
</Frame>

Mit SMS kannst du Kontakte über dieselbe Telefonnummern-Einrichtung erreichen, die du für Anrufe verwendest. Nutze SMS, wenn ein Agent während eines Gesprächs einen Link teilen soll oder wenn ein Workflow nach einem Anruf oder Kontaktereignis automatisch nachfassen soll.

## Voraussetzungen

Du benötigst:

* Eine mobile SMS-fähige Telefonnummer in telli. Prüfe **Telephony** > **Phone Numbers** und achte auf das SMS-Capability-Badge.
* Einen Kontakt mit gültiger Telefonnummer.
* Die Einwilligung, den Empfänger per Nachricht zu kontaktieren, und eine Nachricht, die lokale Messaging-Regeln einhält.

<Warning>
  SMS an Empfänger in den USA werden derzeit nicht unterstützt. Send-Vorgänge an US-Telefonnummern werden als fehlgeschlagen gespeichert.
</Warning>

Wenn du keine SMS-fähige Mobilfunknummer hast, kaufe eine Mobilfunknummer über [Telefonnummern](./phone-numbers). Importierte Nummern, lokale Nummern und reine Voice-Nummern unterstützen SMS nicht.

## SMS aus einem Agenten senden

Verwende ein Agent-SMS-Tool, wenn der Agent während eines Live-Anrufs eine konfigurierte Nachricht senden soll, zum Beispiel einen Buchungslink, Zahlungslink oder eine Bestätigung.

<Steps>
  <Step title="Agenten öffnen">
    Öffne den Agenten, den du bearbeiten möchtest, und gehe im Builder-Seitenbereich zum Bereich für Agent-Tools.
  </Step>

  <Step title="SMS-Tool hinzufügen">
    Klicke unter **SMS** auf **Add SMS tool**.
  </Step>

  <Step title="Label hinzufügen">
    Gib der Nachricht ein Label, zum Beispiel `booking_link` oder `confirmation_sms`. Labels müssen mit einem Buchstaben oder Unterstrich beginnen und dürfen Buchstaben, Zahlen und Unterstriche enthalten.
  </Step>

  <Step title="Absender auswählen">
    Verwende **Use current phone call**, wenn die SMS von der Nummer des Anrufs kommen soll. Wähle eine SMS-fähige Fallback-Nummer, falls die Anrufnummer keine SMS senden kann. Verwende **Manually select number**, wenn die Nachricht immer von einer bestimmten Nummer kommen soll.
  </Step>

  <Step title="Nachricht schreiben">
    Füge den SMS-Text hinzu. Du kannst verfügbare Variablen in die Nachricht einfügen, damit jede Nachricht Kontakt- oder Anrufdetails enthält.
  </Step>

  <Step title="Tool im Prompt referenzieren">
    Füge die SMS-Tool-Referenz in den Prompt ein, zum Beispiel `@sendSms:booking_link`, und beschreibe, wann der Agent sie senden soll.
  </Step>
</Steps>

Der Agent kann nur die SMS-Nachrichten senden, die du konfigurierst. Dadurch bleiben Nachrichten vorhersehbar und der Agent erstellt beim Senden keinen beliebigen Text.

## SMS aus einem Workflow senden

Verwende die Workflow-Aktion **Send SMS**, wenn telli einem Kontakt automatisch eine Nachricht senden soll.

<Steps>
  <Step title="Workflow erstellen oder öffnen">
    Gehe zu **Workflows** und erstelle einen Workflow oder öffne einen vorhandenen Entwurf.
  </Step>

  <Step title="Trigger auswählen">
    Wähle das Ereignis aus, das den Workflow starten soll. SMS eignet sich besonders gut nach **Anruf beendet**-Triggern.
  </Step>

  <Step title="Send SMS hinzufügen">
    Füge nach dem Trigger oder nach einer Bedingung einen Aktionsblock **Send SMS** hinzu.
  </Step>

  <Step title="Absender auswählen">
    Verwende bei call-basierten Workflows die Anrufnummer mit Fallback oder wähle manuell eine SMS-fähige Nummer aus.
  </Step>

  <Step title="Empfänger prüfen">
    Der Workflow sendet die SMS an die Telefonnummer des Kontakts. Stelle sicher, dass der Kontakt eine gültige Mobilfunknummer hat, bevor du testest oder veröffentlichst.
  </Step>

  <Step title="Nachricht schreiben">
    Schreibe den Text und füge Workflow-Variablen ein, wenn du Kontaktfelder, Anrufergebnisse, erfasste Daten oder Werte aus früheren Blöcken brauchst.
  </Step>

  <Step title="Veröffentlichen und testen">
    Veröffentliche den Workflow und führe ihn manuell mit einem aktuellen Anruf aus, bevor du automatische SMS-Sends aktivierst.
  </Step>
</Steps>

Siehe [Workflows](./workflows) für den vollständigen Ablauf zum Veröffentlichen und Überwachen von Workflow-Ausführungen.

Die ersten 20 ausgehenden SMS sind einmalig pro Account kostenlos. Danach 12 ct pro SMS.

## SMS-Aktivität prüfen

SMS-Konversationen erscheinen in **Conversations** neben Anrufen, wenn SMS für deinen Account aktiviert ist. Öffne eine Konversation, um den Nachrichtenverlauf und den Zustellstatus zu sehen.

SMS erscheinen außerdem in der Kontakt-Aktivitätszeitleiste, damit du Follow-ups neben Anrufen und geplanten Aktivitäten des Kontakts prüfen kannst.

Häufige Zustellstatus sind:

| Status        | Bedeutung                                                                            |
| :------------ | :----------------------------------------------------------------------------------- |
| `queued`      | telli hat die Nachricht an den SMS-Anbieter übergeben und sie wartet auf den Versand |
| `sent`        | Der Anbieter hat die Nachricht akzeptiert und gesendet                               |
| `delivered`   | Der Carrier hat die Zustellung an den Empfänger gemeldet                             |
| `undelivered` | Der Carrier konnte die Nachricht nicht zustellen                                     |
| `failed`      | Der Send-Vorgang ist vor der Zustellung fehlgeschlagen                               |

Eingehende Antworten von bekannten Telefonnummern werden der passenden SMS-Konversation hinzugefügt. Antworten von unbekannten Nummern erstellen einen neuen Kontakt aus der Absendernummer.

## Einschränkungen

* SMS unterstützt reine Textnachrichten. Verwende SMS nicht für Medienanhänge.
* SMS an Empfänger in den USA sind derzeit aus Compliance-Gründen blockiert.
* SMS benötigt eine in telli gekaufte Mobilfunknummer mit SMS-Capability.
* Der Nachrichtentext darf nicht leer sein.