WhatsApp-Produkte · Verknüpftes Gerät · API

Senden Sie WhatsApp-Nachrichten aus Ihrer eigenen Software

WASMS ist die über WhatsApp betriebene Form eines SMS-Dienstes. Kein Panel, sondern eine API: Ihr CRM, Ihre E-Commerce-Infrastruktur oder Ihr Kampagnensystem sendet eine HTTP-Anfrage; die Nachricht wird über die Ihrem Unternehmen zugeordnete WhatsApp-Rufnummer an das Telefon des Kunden übermittelt. Text, Bilder, Videos, Dokumente, Audio, Standorte und Kontaktkarten können gesendet werden; der Status wird über dieselbe API abgefragt.

Die Rufnummer wird per QR-Code verknüpft. Dokumente und eine Genehmigung durch Meta sind nicht erforderlich; dafür gibt es auch weder das verifizierte Abzeichen noch die Absicherung der offiziellen API. Beides stellen wir auf dieser Seite klar dar.

Für wen geeignet

Vorgänge, bei denen die Software den Versand auslöst

Alle Stellen, an die eine Benachrichtigung gesendet werden muss, sobald das Ereignis im System eintritt, ohne dass jemand das Panel öffnet und eine Nachricht schreibt.

Transaktionsbenachrichtigungen und Verifizierung

Im E-Commerce, Finanzwesen und in der Logistik werden Bestell-, Versand-, Termin- und Verifizierungsbenachrichtigungen mit einem einzigen Aufruf aus dem bestehenden System an WhatsApp übergeben.

Dokumentenversand

Dateien wie Rechnungen, Belege und Verträge werden einschließlich des Dateinamens direkt an den Kunden übermittelt. Für den Kunden sind sie alle Teil derselben Unterhaltung.

Informationen an Listen mit Einwilligung

An Kundenlisten mit erteilter Einwilligung werden Informationen als Text, Bild oder Dokument gesendet. Weiter unten weisen wir außerdem darauf hin, dass Massenversand und unerwünschte Nachrichten die Rufnummer gefährden.

Inhaltstypen

Was können Sie senden?

Sechs Inhaltstypen sind verfügbar; auch die Schaltflächenliste ist verfügbar. Umfragen und Schaltflächennachrichten sind experimentell und müssen vor dem Einsatz im Produktivbetrieb mit Tecmony abgestimmt werden.

Text

Freitext für Benachrichtigungs-, Verifizierungs- und Informationsabläufe.

Bild und Video

Kampagnenbilder, Produktvorstellungen und kurze Videos.

Dokument

Rechnungen, Belege, Verträge und ähnliche Dateien; einschließlich des Dateinamens.

Audio

Gesprochene Informationen und Erinnerungen.

Kontaktkarte

Kontaktdaten des zuständigen Mitarbeiters oder Bereichs.

Standort

Koordinaten einer Niederlassung, eines Geschäfts oder eines Treffpunkts.

So funktioniert es

Eine Nachricht durchläuft vier Stationen

Die dritte Station ist Ihre Rufnummer; WASMS nutzt sie wie einen Dienst.

Ihr eigenes SystemIhr CRM, E-Commerce- oder Kampagnensystem sendet eine POST-Anfrage.
WASMS APIDas Token wird überprüft; abhängig vom Nachrichtentyp wird der entsprechende Endpunkt ausgeführt und eine message_id zurückgegeben.
Die Ihrem Unternehmen zugeordnete WhatsApp-RufnummerIhre per QR-Code verknüpfte und verifizierte Rufnummer übermittelt die Nachricht.
Ihr KundeDie Nachricht erscheint in WhatsApp unter der Rufnummer Ihres Unternehmens. Der Status wird über dieselbe API anhand der message_id abgefragt.

Ansichten

So sieht es auf dem Telefon des Kunden aus

Kundenseite

Dieselbe Rufnummer, drei verschiedene Aufgaben

Versandbenachrichtigung, Rechnung und Verifizierungscode werden über eine einzige Integration und eine einzige Rufnummer versendet. Antwortet der Kunde, wird die Unterhaltung über dieselbe Rufnummer fortgeführt; wenn ein Team die Antworten bearbeiten soll, können Sie dieselbe Rufnummer auch mit WADesk verbinden.

Benachrichtigung: Bestellung, Versand, Termin
Dokument: Rechnung, Beleg, Vertrag
Verifizierung: Einmalcode

API

Alles Erforderliche für die Integration

Ersetzen Sie in den folgenden Beispielen YOUR_API_TOKEN, YOUR_PHONE_ID und YOUR_PIN durch die Werte, die Ihnen Tecmony mitgeteilt hat. Die Antworten verwenden eine einheitliche Hülle mit den Feldern status, code und data.

1. Authentifizierung: Token abrufen

Mit der Ihnen bereitgestellten phone_id und PIN rufen Sie ein Token ab. Dieses Token wird bei allen nachfolgenden Aufrufen im Header token übermittelt. Fehlt der Header, ist er fehlerhaft oder abgelaufen, wird die Anfrage abgelehnt und ein neues Token muss abgerufen werden.

curl -X GET \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/token?phone_id=YOUR_PHONE_ID&pin=YOUR_PIN"

Antwort:

{
  "status": true,
  "code": 200,
  "data": {
    "phone_id": "9085XXXXXXXX",
    "token": "YOUR_API_TOKEN"
  }
}

2. Textnachricht senden

curl -X POST \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/message/text" \
  -H "token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "905XXXXXXXXX",
    "message": "Siparişiniz kargoya verildi."
  }'

3. Dokument senden

curl -X POST \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/message/document" \
  -H "token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "905XXXXXXXXX",
    "filename": "fatura-2026-04187.pdf",
    "content": "https://ornek.com/fatura.pdf"
  }'

Endpunktliste

Methode	Endpunkt	Body-Felder	Status
GET	`/api/v1/whatsapp/token`	Abfrage: `phone_id`, `pin`	Produktiv
POST	`/api/v1/whatsapp/message/text`	`phone_number`, `message`	Produktiv
POST	`/api/v1/whatsapp/message/image`	`phone_number`, `content`	Produktiv
POST	`/api/v1/whatsapp/message/video`	`phone_number`, `content`	Produktiv
POST	`/api/v1/whatsapp/message/document`	`phone_number`, `filename`, `content`	Produktiv
POST	`/api/v1/whatsapp/message/audio`	`phone_number`, `content`	Produktiv
POST	`/api/v1/whatsapp/message/location`	`phone_number`, `lat`, `lon`, `title`	Produktiv
POST	`/api/v1/whatsapp/message/contact`	`phone_number`, `contact_name`, `contact_number`	Produktiv
POST	`/api/v1/whatsapp/message/button/list`	`phone_number`, `title`, `description`, `button_text`, `rows_title`, `rows[]`	Produktiv
POST	`/api/v1/whatsapp/message/poll`	`phone_number`, `poll_title`, `poll_options[]`	Experimentell
POST	`/api/v1/whatsapp/message/button`	`phone_number`, `media_file`, `media_message`, Schaltflächendefinitionen	Experimentell
GET	`/api/v1/whatsapp/message/{message_id}`	Statusabfrage der gesendeten Nachricht	Produktiv

Alle Endpunkte befinden sich unter https://wasms.tecmony.cloud/api/v1/. Experimentell: Vor der Verwendung in der Produktion ist eine Bestätigung durch Tecmony erforderlich.

Fehlerzustände

200: Die Anfrage wurde verarbeitet; das Feld status gibt true zurück und eine message_id wird bereitgestellt.
400 “Must be connected”: Die WhatsApp-Sitzung der Leitung wurde getrennt. Der QR-Code wird erneut mit dem Telefon des Rufnummerninhabers gescannt; anschließend funktionieren die Aufrufe wieder normal.
Token-Fehler: Der Header token fehlt, ist fehlerhaft oder abgelaufen. Fordern Sie ihn erneut über den Token-Endpunkt an.
502: Meist handelt es sich um eine Zugriffssperre, die von Ihrem Unternehmensnetzwerk ausgeht. Wiederholen Sie dieselbe Anfrage über eine andere Internetverbindung; prüfen Sie mit einer Anfrage an https://wasms.tecmony.cloud/, ob der Dienst verfügbar ist. Eine fehlerfreie Antwort gibt 200 zurück.

Wenden Sie sich für die vollständige Liste der Fehlercodes, die feldbezogenen Validierungsregeln und die Postman-Sammlung an das Supportteam von Tecmony.

Einrichtung

In vier Schritten von der Rufnummernmeldung bis zum ersten Aufruf

Das Konto wird erst nach der Verifizierung der Rufnummer eröffnet; auch der Dienstleistungsvertrag wird vor diesem Schritt unterzeichnet.

RufnummernmeldungSie teilen Tecmony die Rufnummer mit, die Sie für den Versand verwenden werden. Die Rufnummer muss Anrufe oder SMS aus dem Ausland empfangen können; einige Anbieter sperren diesen Verkehr.
VerifizierungUnser Team leitet einen Anruf oder eine SMS an die Rufnummer weiter; Sie teilen uns den Verifizierungscode mit.
KontoeröffnungNach der Verifizierung der Rufnummer erhalten Sie Ihre phone_id- und PIN-Daten; die Leitung wird per QR-Code verbunden.
IntegrationSie starten über den Token-Endpunkt eine Sitzung und rufen anschließend die Nachrichtenendpunkte auf. Eine Postman-Beispielsammlung erhalten Sie von unserem Supportteam.

Grenzen

Was WASMS nicht leistet und was Sie wissen sollten

Die Einschränkungen des Wegs über verknüpfte Geräte. Sie standen bereits auf unserer alten Website und stehen auch hier.

Es handelt sich nicht um die offizielle WhatsApp Business API. Der Kunde sieht nur die Rufnummer und das zugehörige Profil; ein Abzeichen für verifizierte Unternehmen ist nicht erhältlich. Wenn Sie ein Abzeichen und einen offiziellen Zustellbericht benötigen, sehen Sie sich WaSend an.
WhatsApp kann die Rufnummer einschränken oder sperren. Artikel 7 unseres Dienstleistungsvertrags: Bei einem Produkt, das durch die Verknüpfung eines Geräts mit einem WhatsApp-Konto funktioniert, kann WhatsApp die Rufnummer gemäß seinen eigenen Richtlinien einschränken; der Kunde entscheidet sich in Kenntnis dieses Risikos für den Dienst. Massenhafte und unerwünschte Nachrichten erhöhen dieses Risiko deutlich.
Wenn die Verbindung unterbrochen wird, geben Anfragen “Must be connected” zurück. Wird die Sitzung auf dem Telefon beendet, wird der Versand angehalten, bis der QR-Code erneut gescannt wurde. Fangen Sie diesen Fehler in Ihrem Versandablauf ab und erzeugen Sie eine Warnung.
Es kann ausschließlich eine Mobilfunknummer verwendet werden. Eine Festnetz- oder virtuelle Rufnummer eignet sich für diesen Weg nicht; die Rufnummer muss auf einem Telefon mit WhatsApp verknüpft sein.
Umfrage- und Schaltflächennachrichten sind experimentell. Vor dem Einsatz in der Produktion ist eine Bestätigung durch Tecmony erforderlich; sie sind nicht vom Vertrag abgedeckt.
Es werden keine Einwilligungen eingeholt. Um einer Person eine Nachricht zu senden, muss diese zuvor eine Einwilligung erteilt haben, in der der Name Ihres Unternehmens genannt wird; für die Einholung der Einwilligung und deren Rechtskonformität ist der Kunde verantwortlich.
Dies ist kein Kanal für sensible Daten. Zahlungskartennummern, Finanzkontodaten und Identifikationsnummern dürfen über diesen Kanal weder geteilt noch von Kunden angefordert werden.

Häufig gestellte Fragen

Fragen vor der Integration

Wenn Ihre Frage hier nicht beantwortet wird, schreiben Sie uns. Falls ein anderer Weg besser geeignet ist: WADesk für die gemeinsame Bearbeitung eingehender Nachrichten im Team, WaSend für Massenkampagnen mit genehmigten Vorlagen und WAGEM für ein schreibgeschütztes Archiv. Einen Vergleich finden Sie auf der Seite WhatsApp-Produkte.

Was ist der Unterschied zwischen WASMS und einem SMS-Dienst?

WASMS ist die über WhatsApp betriebene Form eines konventionellen SMS-Dienstes. Ihre eigene Anwendung, Ihr CRM oder Ihr Kampagnensystem stellt eine Verbindung zur API her; der Unterschied besteht darin, dass die Nachricht statt per SMS über die Ihrem Unternehmen zugewiesene WhatsApp-Leitung versendet wird und Sie neben Text auch Bilder, Videos, Dokumente, Audioinhalte, Kontaktkarten und Standorte senden können.

Was ist der Unterschied zwischen WASMS und WaSend?

Die Infrastruktur. WASMS funktioniert über eine per QR-Code verknüpfte Rufnummer: Es sind keine Unterlagen und keine Genehmigung durch Meta erforderlich, aber es gibt auch kein Verifizierungsabzeichen und WhatsApp kann die Rufnummer sperren. WaSend funktioniert über die offizielle WhatsApp Business API: Eine Unternehmensverifizierung und die Genehmigung von Vorlagen sind erforderlich, die Gesprächsgebühr von Meta fällt an; dafür erhalten Sie ein verifiziertes Profil und einen offiziellen Zustellbericht.

Welche Nachrichtentypen sind produktiv verfügbar und welche experimentell?

Die Endpunkte für Text, Bilder, Videos, Dokumente, Audioinhalte, Standorte, Kontaktkarten und Schaltflächenlisten sind produktiv verfügbar. Umfrage- und Schaltflächennachrichten sind experimentell; wenn Sie ihren Einsatz in der Produktion planen, bestätigen Sie dies zunächst mit Tecmony.

Wie lange ist das Token gültig?

Das Token wird mit phone_id und PIN abgerufen und bei allen nachfolgenden Aufrufen im token-Header übermittelt. Fehlt der Header, ist er fehlerhaft oder abgelaufen, wird die Anfrage abgelehnt; in diesem Fall rufen Sie über den Token-Endpunkt ein neues Token ab.

Was soll ich tun, wenn die Anfrage 502 zurückgibt?

Dies ist in der Regel eine Zugriffssperre, die durch Ihr Unternehmensnetzwerk verursacht wird. Wiederholen Sie dieselbe Anfrage über eine andere Internetverbindung. Sie können die Verfügbarkeit des Dienstes auch mit einer Anfrage an wasms.tecmony.cloud überprüfen; eine fehlerfreie Antwort wird mit dem Code 200 zurückgegeben.

Was bedeutet der Fehler “Must be connected”?

Dies bedeutet, dass die WhatsApp-Sitzung der Leitung auf dem Telefon unterbrochen wurde. Der Inhaber der Rufnummer scannt den neuen QR-Code in WhatsApp auf dem Telefon über den Menüpunkt Verknüpfte Geräte; sobald die Verbindung hergestellt ist, werden die Anfragen wieder normal verarbeitet. Dies liegt in der Natur des Wegs über verknüpfte Geräte.

Kann ich den Status einer gesendeten Nachricht abfragen?

Ja. Der Endpunkt GET /api/v1/whatsapp/message/{message_id} gibt den Status der gesendeten Nachricht zurück. Die Antworten verwenden den gemeinsamen Umschlag mit den Feldern status, code und data.

Ist für den Nachrichtenversand die Einwilligung des Kunden erforderlich?

Ja. WASMS arbeitet im Rahmen der Regeln von WhatsApp LLC: Um einer Person eine Nachricht senden zu können, muss diese zuvor eine Einwilligung erteilt haben, in der der Name Ihres Unternehmens ausdrücklich genannt wird. Für die Methode zur Einholung der Einwilligung und deren Rechtskonformität ist der Kunde verantwortlich.

Führen Sie noch heute den ersten Aufruf aus

Teilen Sie uns Ihre Rufnummer mit; nach der Verifizierung senden Sie mit phone_id und PIN innerhalb weniger Minuten Ihre erste Nachricht.

Demo anfordern

Oder kontaktieren Sie uns direkt: +90 (216) 912 00 79[email protected]