Zum Hauptinhalt springen
connic
Starte kostenlos

Telnyx Messaging

Von connic
InboundOutbound

Lass einen Agenten SMS-, WhatsApp- und RCS-Nachrichten an deinen Telnyx-Absender beantworten und aus jedem Run Antworten, Medien und genehmigte WhatsApp-Vorlagen senden.

Zu einem Agenten hinzufügenSprich mit Sales
Publisher
Von connic
Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
Telnyx Messaging Docs

Mach aus eingehenden Nachrichten Agent-Runs

Eine Inbound-Verbindung empfängt Nachrichten für einen Kanal und einen Absender aus deinem Telnyx-Konto. Eine Outbound-Verbindung mit denselben Einstellungen sendet die Antwort.

Eine gemeinsame Telnyx-Connection
Speichere den API-Schlüssel und den öffentlichen Ed25519-Schlüssel des Kontos einmal. Auch Telnyx Voice nutzt diese Connection, und jede Verbindung wählt ihren eigenen Kanal und Absender.
Was connic einrichtet
connic setzt den Webhook für eingehende Nachrichten am Messaging-Profil der Nummer oder am RCS-Agenten. Dabei ersetzt connic den primären Webhook, entfernt den Failover-Webhook und einen zugeordneten Telnyx-KI-Assistenten und schreibt die alten Werte in die Logs. Das Profil darf nur diese Nummer enthalten.
Externe WhatsApp-Nummern
Findet connic das Messaging-Profil der Nummer nicht, gibst du die Profil-ID an und trägst die erzeugte Webhook-URL in Telnyx an diesem Profil ein.

  1. Der Kunde schreibt an deinen Absender

    Eine SMS oder MMS an deine Nummer, eine WhatsApp-Nachricht an deine registrierte Nummer oder eine RCS-Nachricht an deinen RCS-Agenten.

  2. connic prüft das Ereignis

    Der öffentliche Ed25519-Schlüssel des Kontos prüft Signatur und Zeitstempel. Danach gleicht connic Messaging-Profil, Kanal und Empfänger mit der Verbindung ab.

  3. Die verknüpften Agenten laufen

    Jeder verknüpfte Agent bekommt Text, Absender, heruntergeladene Anhänge und eine Unterhaltungs-ID. Wird dasselbe Ereignis erneut zugestellt, landet es im selben Run.

  4. Die Outbound-Verbindung antwortet

    Steht kein Empfänger im Output, geht die Antwort an den geprüften Absender der eingegangenen Nachricht.

Gib dem Agenten Nachricht, Absender und Dateien

Die Eingabe des Runs enthält vereinheitlichte Nachrichtenfelder und unter raw die ursprünglichen Telnyx-Daten.

Anhänge
connic lädt bis zu 10 Dateien pro Nachricht innerhalb eines gemeinsamen Budgets von 10 MiB herunter und übergibt sie base64-codiert in files. Was connic auslässt, steht mit Grund in file_issues.
Gesprächsverlauf
Setze session.key auf input.conversation_id, dann teilen Folgenachrichten desselben Kunden an denselben Absender den Verlauf. Ohne Session-Konfiguration startet jede Nachricht einen unabhängigen Run.
Bestätigungen und pausierte Verbindungen
Zustell- und Lesebestätigungen sowie Nachrichten-Echos starten keine Runs. Eine pausierte Verbindung bestätigt gültige Nachrichten, ohne ihre Agenten zu starten.
context["payload"]
{
  "event_id": "7a3a86b3-0e77-48f6-914a-63ad28b7d64e",
  "message_id": "4031938e-60e4-4235-a8dd-0b1c55a23e7a",
  "channel": "whatsapp",
  "from": "+4915112345678",
  "to": "+4930123456789",
  "text": "Is this the right cable for my device?",
  "conversation_id": "telnyx_messaging:9e0f77d9-2fd8-5a8e-8d47-59fbf5b8a091",
  "files": [
    {
      "name": "attachment-1.jpg",
      "mime_type": "image/jpeg",
      "data": "<base64-bytes>",
      "size": 284512
    }
  ]
}
agents/support-assistant.yaml
version: "1.0"
name: support-assistant
type: llm
model: connic/gpt-5.6-terra
description: Answers customer messages
system_prompt: |
  Answer the incoming message briefly.
  Check files and file_issues before you reply.
tools:
  - retrieval_query
session:
  key: input.conversation_id
  ttl: 86400

Antworte, benachrichtige oder sende eine Vorlage

Sende automatisch nach einem Run, als Agent-Tool oder aus Middleware. Text, öffentliche Medien-URLs und genehmigte WhatsApp-Vorlagen laufen über dieselbe Verbindung.

Wer die Nachricht bekommt
Ein ausdrückliches to im Output hat Vorrang, danach folgt der Standardempfänger der Verbindung und zuletzt der geprüfte Absender der eingegangenen Nachricht.
Medien je Kanal
MMS nimmt bis zu 10 Medien-URLs. WhatsApp und RCS nehmen jeweils eine. WhatsApp braucht zusätzlich einen media_type, und RCS sendet Text und Medien als getrennte Nachrichten.
WhatsApp-Vorlagen
Außerhalb des Kundenservicefensters sendest du eine genehmigte Vorlage über template_id oder über name und language.code, optional mit components. Hinterlege sie als Standard der Verbindung oder gib sie pro Nachricht mit.
Zustellstatus
Der Outbound-Run speichert die Nachrichten-ID, sobald Telnyx die Nachricht annimmt, und die endgültige Zustellung siehst du in Telnyx. Ist nach einem Timeout unklar, ob sie angenommen wurde, prüfe die Nachrichtenprotokolle in Telnyx, bevor du erneut sendest.
whatsapp-image.json
{
  "to": "+4915112345678",
  "text": "Your shipping label",
  "media_urls": ["https://example.com/shipping-label.png"],
  "media_type": "image"
}
whatsapp-template.json
{
  "to": "+4915112345678",
  "whatsapp_template": {
    "name": "order_confirmation",
    "language": {"code": "en_US"},
    "components": [{
      "type": "body",
      "parameters": [{"type": "text", "text": "1042"}]
    }]
  }
}

Deklariere beide Richtungen im Code

Halte die Inbound- und die Outbound-Verbindung in connectors/. Die source an der Outbound-Verknüpfung beschränkt Antworten auf Runs, die die Inbound-Verbindung gestartet hat, und der API-Schlüssel bleibt in der Connection.

connectors/support-whatsapp.yaml
type: telnyx_messaging
mode: inbound
name: Support WhatsApp
connection: support-telnyx
config:
  channel: whatsapp
  sender: "+4930123456789"
agents:
  - support-assistant
connectors/support-replies.yaml
type: telnyx_messaging
mode: outbound
connection: support-telnyx
config:
  channel: whatsapp
  sender: "+4930123456789"
agents:
  - name: support-assistant
    outbound: { usage: automatic, source: [support-whatsapp] }

Wo Telnyx Messaging passt

Wähle ein Szenario und sieh, was ankommt, welcher Agent läuft und was er zurückschickt.

Kunden schicken eine Bestellnummer, und der Agent antwortet von derselben Nummer mit dem aktuellen Stand.

Kunden-SMS
Inbound SMS
order-assistant
SMS-Antwort von deiner Nummer
context["payload"]
{
  "event_id": "1f6c2a0e-8b3d-4d6f-9a51-2c7e4b9d0a13",
  "message_id": "6b2d9e41-3c7a-4f08-b5e2-9d1a7c4f8e20",
  "channel": "sms",
  "from": "+4915112345678",
  "to": "+4930123456789",
  "text": "Has order 1042 shipped yet?",
  "conversation_id": "telnyx_messaging:3c9e1d47-6a2b-5f80-9e4d-1b7a2c8f6d35"
}
agent-output.json
{
  "text": "Order 1042 shipped on October 12 and arrives on Thursday."
}

Ein Kunde schickt ein Foto mit einer Frage, und der Agent antwortet mit einem Anleitungsbild.

WhatsApp-Kunde
Inbound WhatsApp
device-support
Antwort mit Anleitungsbild
context["payload"]
{
  "event_id": "7a3a86b3-0e77-48f6-914a-63ad28b7d64e",
  "message_id": "4031938e-60e4-4235-a8dd-0b1c55a23e7a",
  "channel": "whatsapp",
  "from": "+4915112345678",
  "to": "+4930123456789",
  "text": "Is this the right cable for my device?",
  "conversation_id": "telnyx_messaging:9e0f77d9-2fd8-5a8e-8d47-59fbf5b8a091",
  "files": [
    {
      "name": "attachment-1.jpg",
      "mime_type": "image/jpeg",
      "data": "<base64-bytes>",
      "size": 284512
    }
  ]
}
agent-output.json
{
  "text": "Yes, that cable fits. Plug it into port B, shown here.",
  "media_urls": ["https://example.com/guides/port-b.png"],
  "media_type": "image"
}

Nachrichten an deinen RCS-Agenten erreichen einen Agenten, der die passende Serviceanleitung nachschlägt.

RCS-Kunde
Inbound RCS
install-helper
RCS-Antwort mit dem nächsten Schritt
context["payload"]
{
  "event_id": "5d8b3f12-9c4e-4a7b-8e61-0f2d6c9a4b37",
  "message_id": "a2e7c591-4b3d-4e86-9f20-7d1c5b8e3a64",
  "channel": "rcs",
  "from": "+4915112345678",
  "to": "example_support",
  "text": "Where does the replacement filter go?",
  "conversation_id": "telnyx_messaging:7b4d2e98-1f6a-5c3b-a8e7-4d9c0b2f5e61"
}
agent-output.json
{
  "text": "Open the front panel and slide the filter into slot F2."
}

Dein Buchungssystem sendet jede neue Buchung, und der Agent schickt dem Kunden eine genehmigte WhatsApp-Vorlage.

Buchungssystem
Inbound Webhook
booking-notifier
WhatsApp-Vorlage über Telnyx
booking.json
{
  "booking_id": "B-2041",
  "customer_phone": "+4915112345678",
  "service": "Boiler service",
  "starts_at": "2026-10-21T09:00:00+02:00"
}
agent-output.json
{
  "to": "+4915112345678",
  "whatsapp_template": {
    "name": "booking_confirmation",
    "language": {"code": "en_US"},
    "components": [{
      "type": "body",
      "parameters": [
        {"type": "text", "text": "Boiler service"},
        {"type": "text", "text": "October 21, 9:00"}
      ]
    }]
  }
}

FAQ zu Telnyx Messaging

Ja, wenn die Nummer in Telnyx für beide Kanäle eingerichtet ist. Lege pro Kanal eine Verbindung mit derselben Connection und demselben Messaging-Profil an. Beide teilen sich einen Webhook, und connic ordnet jede Nachricht der passenden Verbindung zu.

Ja. Starte den Agenten über einen Zeitplan, einen Webhook oder eine andere Verbindung und sende über eine Outbound-Verbindung, mit einem Empfänger im Output oder einem Standardempfänger. Außerhalb des WhatsApp-Kundenservicefensters brauchst du eine genehmigte Vorlage.

Ja, sobald du eine Session konfigurierst. Setze session.key auf input.conversation_id und wähle eine ttl. Jede Kombination aus Verbindung, Kanal, Absender und Kunde bekommt ihre eigene Unterhaltung. Die vollständige Eingabe zeigt die Dokumentation zu Telnyx Messaging.

Nein. Nummern, die Registrierung für WhatsApp und RCS sowie die Freigabe von Vorlagen bleiben in Telnyx. connic zeigt die Absender an, die dein Konto schon hat, und sendet die genehmigten Vorlagen, die du angibst.

Er heißt, dass Telnyx die Nachricht angenommen hat. Der Run speichert die Nachrichten-ID von Telnyx, mit der du dort den endgültigen Zustellstatus nachsiehst.

Weitere Verbindungen

Zum Marketplace