Hilfe

Erste Schritte

Von der Registrierung bis zum ersten antwortenden Kunden – sechs Schritte. Bei der ersten Registrierung erhalten Sie eine einmonatige Testversion mit vollem Zugriff.

Kanäle verbinden

Schritt‑für‑Schritt‑Anleitungen für jeden Kanal. Kanäle werden pro Site (Widget) im Dashboard im Abschnitt „Kanäle“ verbunden; Nachdem ein Kanal gespeichert wurde, prüft Smartbtn, ob die Plattform Nachrichten akzeptiert. Nachrichten von jedem Kanal kommen in „Gespräche“ an.

Telegram‑BotSie benötigen: einen Bot von @BotFather, seinen Benutzernamen und sein Token.6 Schritte → VK‑CommunitySie benötigen: einen Community‑Zugangsschlüssel und den Community‑Link oder die Community‑ID.5 Schritte → MAX‑BotSie benötigen: eine verifizierte Organisation auf business.max.ru, den Bot‑Spitznamen und das Token.6 Schritte → WhatsApp Business (Cloud‑API)Sie benötigen: eine Meta Business‑App mit WhatsApp, eine Nummer, eine Telefonnummer‑ID, eine WABA‑ID und einen permanenten Token.6 Schritte · ca. 10 Minuten → Avito‑KontenSie benötigen: ein Avito‑Konto mit einem geeigneten Abonnement; Autorisierung über Avito.4 Schritte → CIANSie benötigen: den „Basic“-CIAN‑Plan, den CIAN‑API‑Schlüssel und die Kontoadresse.5 Schritte → Facebook MessengerSie benötigen: ein langlebiges Seitenzugriffstoken und die Seitenadresse.5 Schritte → Viber‑BotSie benötigen: einen kommerziellen Viber‑Bot, dessen URI und Token (App‑Schlüssel).5 Schritte → OK GruppeSie benötigen: einen Zugriffsschlüssel und den Gruppendialog‑Link.6 Schritte → AliExpressSie benötigen: ein API‑Token vom AliExpress‑Verkäuferkonto und die Adresse oder ID des Geschäfts.5 Schritte → Apple‑Nachrichten für UnternehmenSie benötigen: ein mit Infobip verknüpftes Messages for Business‑Konto, eine Apple Business ID und einen Infobip‑API‑Schlüssel.7 Schritte → WordPress und andere CMSInstallieren des Widget‑Codes auf einer mit einem CMS erstellten Website.3 Schritte →

Telegram‑Bot

Kunden schreiben Ihrem Bot in Telegram, Sie antworten von Smartbtn – die Antwort kommt in Telegram an.

1. Erstellen Sie einen Bot mit @BotFatherÖffnen Sie in Telegram @BotFather, senden Sie den Befehl /newbot und legen Sie den Namen und Benutzernamen des Bots fest. Der Benutzername muss mit „bot“ enden.
2. Kopieren Sie den TokenBotFather sendet ein Token wie 123456:AAH… – kopieren Sie es vollständig.
3. Geben Sie den Bot‑Benutzernamen einÖffnen Sie im Dashboard „Kanäle“, wählen Sie Telegram und geben Sie den Bot‑Benutzernamen ohne @ ein.
4. Fügen Sie das Token einFügen Sie das Token in das Feld „Bot‑Token“ ein.
5. Telegram verbindenKlicken Sie auf „Telegramm verbinden“. Smartbtn fragt Telegram, ob der Bot antwortet – die grüne Markierung erscheint erst nach seiner Antwort.
6. Senden Sie /start an den BotÖffnen Sie den Bot im Telegram und senden Sie ihn /start. Danach kann es mit Kunden sprechen.

VK‑Community

Nachrichten an Ihre VK‑Community kommen an Smartbtn; Antworten gehen im Namen der Community an VK zurück. Sie können mehrere Communities verbinden.

1. Erstellen Sie einen Community‑ZugriffsschlüsselÖffnen Sie in der Community „Verwalten“ → „Erweitert“ → „API‑Nutzung“ → Registerkarte „Zugriffstokens“ → „Token erstellen“. Markieren Sie die Rechte „Community‑Nachrichten“, „Community‑Verwaltung“, „Fotos“, „Dokumente“ und klicken Sie auf „Erstellen“; in der VK‑App oder per SMS bestätigen.
2. Fügen Sie den Schlüssel einÖffnen Sie im Dashboard „Kanäle“ → VK und fügen Sie den Schlüssel in das Feld „Community‑Token“ ein.
3. Geben Sie die Community anFügen Sie im Feld „Community‑Link oder ID“ die Community‑Adresse (z. B. vk.com/club123456) oder ihre numerische ID ein.
4. Vernetzen Sie die CommunityKlicken Sie auf „Verbinden“. Der Empfang von Nachrichten (Callback‑API, message_new‑Ereignis) wird automatisch konfiguriert – es ist nichts weiter zu tun.
5. ÜberprüfenSenden Sie eine Testnachricht an die Community – sie sollte unter „Konversationen“ erscheinen.

MAX‑Bot

Nachrichten an Ihren Bot im MAX‑Messenger kommen an Smartbtn, Antworten gehen zurück an MAX.

1. Erstellen Sie einen Bot auf der MAX‑PartnerplattformMelden Sie sich bei business.max.ru (oder der Mini‑App „MAX for Business“) an, erstellen und überprüfen Sie das Profil Ihrer Organisation, Ihres Einzelunternehmers oder Selbstständigen (verfügbar für Einwohner Russlands) und klicken Sie dann unter „Chatbots“ auf „Erstellen“.
2. Füllen Sie die Bot‑Karte ausLaden Sie ein Logo hoch, legen Sie den Namen und die Beschreibung fest. Der Spitzname wird automatisch generiert (wie idINN_bot). Nach der Erstellung durchläuft der Bot die Moderation.
3. Kopieren Sie den TokenÖffnen Sie nach der Moderation „Chat‑Bots“ → Ihren Bot → ⋮ → „Einstellungen“ und kopieren Sie den Token.
4. Geben Sie den Bot‑Spitznamen einÖffnen Sie im Dashboard „Kanäle“ → MAX und geben Sie den Spitznamen ohne @ ein.
5. Fügen Sie das Token einFügen Sie das Token in das Feld „Bot‑Token“ ein.
6. SpeichernKlicken Sie auf „Einstellungen speichern“.

WhatsApp Business (Cloud‑API)

WhatsApp ist über die offizielle Meta WhatsApp Business Cloud API verbunden: Eine Nummer antwortet in Gesprächen und versendet Mailings mit genehmigten Vorlagen. Die Einrichtung im Abschnitt „Verbindungen“ dauert etwa 10 Minuten.

1. Erstellen Sie eine Meta‑AppErstellen Sie in Meta für Entwickler eine Business‑App (oder verwenden Sie eine vorhandene) und fügen Sie das WhatsApp‑Produkt hinzu.
2. Fügen Sie die Nummer hinzuWhatsApp → API‑Setup: Fügen Sie Ihre Nummer hinzu (sie darf nicht in der WhatsApp‑App verwendet werden), bestätigen Sie sie mit einem Code und warten Sie auf die Genehmigung des Anzeigenamens.
3. Kopieren Sie die IDsKopieren Sie die Telefonnummer‑ID und die WhatsApp Business‑Konto‑ID.
4. Erstellen Sie einen permanenten TokenMeta Business → Einstellungen → Systembenutzer: Erstellen Sie einen Administrator, geben Sie ihm die App und das WhatsApp‑Konto, generieren Sie ein Token, das nie abläuft, mit den Berechtigungen whatsapp_business_messaging und whatsapp_business_management.
5. Speichern und prüfenÖffnen Sie im Dashboard „Verbindungen“ → WhatsApp, fügen Sie die Daten ein und klicken Sie auf „Speichern und prüfen“.
6. Eingehende Nachrichten aktivierenKlicken Sie auf „Automatisch verbinden“ und wählen Sie die Websites (Projekte) für Antworten und Mailings aus.

Avito‑Konten

Avito‑Chats sind durch Konten verbunden: Jedes Konto ist eine separate Autorisierung in Avito, Sie können mehrere hinzufügen. Es ist ein Avito‑Abonnement erforderlich: „Maximum“ für Waren und Aufträge, „Erweitert“ oder „Maximum“ für Dienstleistungen.

1. Benennen Sie das KontoGeben Sie unter „Kanäle“ → Avito einen Kontonamen ein (bis zu 50 Zeichen) – das hilft, Konten voneinander zu unterscheiden.
2. Fügen Sie das Konto hinzuKlicken Sie auf „Konto hinzufügen“ – die Avito‑Autorisierungsseite wird geöffnet.
3. Zugriff erlaubenMelden Sie sich beim richtigen Avito‑Konto an, überprüfen Sie die Rechte zum Lesen und Ändern von Nachrichten im Avito‑Messenger und klicken Sie auf „Anwendung autorisieren“.
4. Konten verwaltenFügen Sie weitere Konten hinzu oder löschen Sie nicht benötigte Konten – die Liste befindet sich auf derselben Seite.

CIAN

Nachrichten von Ihrem CIAN‑Konto kommen an Smartbtn.

1. Holen Sie sich den CIAN‑API‑SchlüsselDer „Basic“-Plan ist erforderlich. Öffnen Sie im CIAN‑Konto den API‑Bereich und klicken Sie auf „API‑Schlüssel abrufen“.
2. Finden Sie den Schlüssel in Ihrer E‑MailCIAN sendet den ZUGRIFFSSCHLÜSSEL an die E‑Mail‑Adresse des Kontos. Stellen Sie außerdem sicher, dass der Empfang von Nachrichten in my.cian.ru/settings/chats aktiviert ist.
3. Geben Sie die Kontoadresse einFügen Sie unter „Kanäle“ → CIAN Ihre CIAN‑Kontoadresse ein.
4. Fügen Sie den Schlüssel einFügen Sie den Schlüssel in das Feld „CIAN API key (ACCESS KEY)“ ein.
5. SpeichernKlicken Sie auf „Einstellungen speichern“.

Facebook Messenger

Nachrichten, die im Messenger an Ihre Facebook‑Seite gesendet werden, gelangen an Smartbtn. Messenger ermöglicht Freiform‑Antworten innerhalb von 24 Stunden nach der Nachricht des Kunden.

1. Wählen Sie MessengerKlicken Sie unter „Kanäle“ auf das Messenger‑Symbol.
2. Holen Sie sich das SeitentokenErhalten Sie ein langlebiges Seitenzugriffstoken, indem Sie dem Meta für Entwickler‑Leitfaden folgen.
3. Geben Sie die Seitenadresse einFügen Sie die Adresse der Facebook‑Seite in das Feld „Adresse der Facebook‑Seite“ ein.
4. Fügen Sie das Token einFügen Sie das Seiten‑Token in das Feld „Geheimer Schlüssel“ ein.
5. SpeichernKlicken Sie auf „Einstellungen speichern“.

Viber‑Bot

Nachrichten an Ihren Viber‑Bot kommen an Smartbtn.

1. Wählen Sie ViberKlicken Sie unter „Kanäle“ auf das Viber‑Symbol.
2. Holen Sie sich einen Viber‑BotSeit dem 5. Februar 2024 werden Viber‑Bots nur noch zu kommerziellen Bedingungen erstellt: Bewerben Sie sich direkt bei Viber oder über seinen offiziellen Partner (developers.viber.com). Das Token befindet sich in Viber: Mehr → Einstellungen → Bots → Informationen bearbeiten → „Ihr App‑Schlüssel“.
3. Geben Sie den Bot‑URI einFügen Sie den Bot‑URI (derselbe wie in viber://pa?chatURI=… Links) in das Feld „Bot‑URI“ ein.
4. Fügen Sie das Token einFügen Sie den App‑Schlüssel in das Feld „Bot‑Token“ ein.
5. SpeichernKlicken Sie auf „Einstellungen speichern“.

OK Gruppe

Nachrichten an Ihre OK‑Gruppe kommen an Smartbtn.

1. Holen Sie sich einen ZugangsschlüsselRufen Sie den Gruppenzugriffsschlüssel ab, wie im OK API‑Leitfaden beschrieben.
2. Wählen Sie OKKlicken Sie unter „Kanäle“ auf das OK‑Symbol.
3. Geben Sie die Gruppenadresse einKopieren Sie in den Gruppeneinstellungen aus „Direkter Link zum Gruppendialog“ den Teil wie group/58269558636565/messages und fügen Sie ihn in das Feld „Gruppenadresse“ ein.
4. Fügen Sie den Schlüssel einFügen Sie den Schlüssel aus Schritt 1 in das Feld „Zugriffsschlüssel (Token)“ ein.
5. SpeichernKlicken Sie auf „Einstellungen speichern“. Der Webhook wird automatisch registriert.
6. ÜberprüfenSmartbtn zeigt an, ob OK den Empfang von Nachrichten bestätigt hat. Senden Sie eine Testnachricht an die Gruppe – sie wird unter „Konversationen“ angezeigt.

AliExpress

Käufernachrichten von AliExpress kommen an Smartbtn.

1. Öffnen Sie die Seite mit den API‑TokensMelden Sie sich beim Verkäuferkonto an (seller.aliexpress.ru) und öffnen Sie seller.aliexpress.ru/token‑management/active.
2. Erstellen Sie einen TokenKlicken Sie auf „Token erstellen“, dann auf das Token und kopieren Sie es.
3. Geben Sie den Shop anGeben Sie unter „Kanäle“ → AliExpress die Adresse oder ID Ihres Geschäfts ein.
4. Fügen Sie das Token einFügen Sie das Token in das Feld „API‑Token“ ein.
5. SpeichernKlicken Sie auf „Einstellungen speichern“.

Apple Messages for Business

Nachrichten von Apple Messages for Business (ehemals Business Chat) gelangen über den Anbieter Infobip zu Smartbtn: Apple gewährt Unternehmen keinen direkten Zugriff.

1. Registrieren Sie sich bei AppleRegistrieren Sie die Organisation im Apple Business Register (register.apple.com) und erstellen Sie ein Messages for Business‑Konto. Wählen Sie Infobip als Messaging‑Dienstanbieter.
2. Verknüpfen Sie das Konto mit InfobipVerknüpfen Sie das Konto mit Ihrem Infobip‑Konto und warten Sie auf die Genehmigung von Apple – der Status lautet ONLINE.
3. Geben Sie die Infobip‑Basis‑URL einFügen Sie unter „Kanäle“ → „Nachrichten für Unternehmen“ Ihre Infobip‑Basis‑URL ein (z. B. xxxxx.api.infobip.com).
4. Geben Sie die Apple Business ID einKopieren Sie es in das Apple Business Register: das Messages for Business‑Konto → „Links“ → „Copy ID“.
5. Fügen Sie den Infobip‑API‑Schlüssel einErstellen Sie einen API‑Schlüssel in Infobip (API‑Schlüsselverwaltung) und fügen Sie ihn ein – die Rückruf‑URL erscheint unten.
6. Legen Sie die Rückruf‑URL in Infobip festFügen Sie in Infobip: Kanäle und Nummern → Kanäle → Apple Messages for Business → Absender → ⋮ → Eingehende Konfigurationen bearbeiten → Weiterleitung an HTTP die Rückruf‑URL ein.
7. SpeichernKlicken Sie auf „Einstellungen speichern“.

WordPress, Tilda und andere CMS

Das Widget wird mit einem Installationscode installiert – es funktioniert auf jeder Site und jedem CMS.

1. Kopieren Sie den InstallationscodeÖffnen Sie im Dashboard „Widget“ und kopieren Sie den Installationscode.
2. Fügen Sie es in die Site einFügen Sie den Code auf jeder Seite vor dem schließenden -Tag hinzu: in WordPress – über das Theme (footer.php) oder ein beliebiges Plugin zum Einfügen von Code in die Kopf-/Fußzeile; in anderen CMS – im Feld für benutzerdefinierten HTML/JS‑Code.
3. ÜberprüfenÖffnen Sie die Site – die Schaltfläche erscheint; Weitere Designänderungen werden im Dashboard vorgenommen, ohne dass der Code neu installiert werden muss.

Wissensdatenbank

Wird helfen, Vorschläge machen, lehren. Beginnen Sie mit der Eingabe – die Liste wird während der Eingabe gefiltert.

smartbtn_widget_api.setContactInfo({
  name: „Alex Morgan“,
  email: "email@example.com",
  phone: "+17584987855",
  description: "Description text"
});

smartbtn_widget_api.setCustomData([
  {
    title: "Actions",
    content: "Add contact",
    link: "https://crm.example.com/contacts/new"
  },
  {
    content: "Open customer profile",
    link: "https://crm.example.com/customers/42"
  }
]);

curl -H "Authorization: Bearer <token>" https://<host>/api/v1/chats

// → { "data": [...], "next_cursor": "..." | null }

• Eigenständiges PWA‑Fenster ohne Browser‑Adressleiste, mit Dock‑Badge und Web‑Push‑Benachrichtigungen
• Sofortiger Zugriff auf alle Tools: WhatsApp, Telegram, Instagram, Messenger, KI‑Copilot, Chatbot, Rückruf, Wegbeschreibung, Preis
• Push‑Benachrichtigungen für neue Nachrichten und Rückrufwünsche
• Bedienerüberwachung, SLA‑Timer und Statistiken – direkt in der App

Kontaktieren Sie uns

Haben Sie eine Frage oder einen Vorschlag? Schreiben Sie uns!

Firmendetails

Betreiberdaten für Verträge und Rechnungen.

Juristische Dokumente

Nutzungsbedingungen des Dienstes und Verarbeitung personenbezogener Daten.