Integrationsleitfaden

1. WhatsApp Business API-Integration

Die WhatsApp Business API-Integration ermöglicht es, eingehende WhatsApp-Nachrichten Ihrer Kunden automatisch in Bestellungen umzuwandeln.

Erforderliche Informationen

Schritt 1: Meta Business-Konto erstellen

1. Gehen Sie zu business.facebook.com.
2. Erstellen Sie ein neues Konto, falls Sie noch kein Meta Business-Konto haben.
3. Schließen Sie die Unternehmensverifizierung ab.

Schritt 2: Meta Developer-Konto erstellen

1. Gehen Sie zu developers.facebook.com.
2. Klicken Sie auf „Loslegen" und erstellen Sie Ihr Entwicklerkonto.
3. Verknüpfen Sie es mit Ihrem Meta Business-Konto.

Schritt 3: WhatsApp-App erstellen

1. Klicken Sie im Developer Dashboard auf „App erstellen".
2. Wählen Sie „Unternehmen" als App-Typ.
3. Geben Sie den App-Namen ein (z. B. „Convord Integration").
4. Wählen Sie Ihr Meta Business-Konto und erstellen Sie die App.

Schritt 4: WhatsApp-Produkt hinzufügen

1. Gehen Sie im App-Dashboard zum Bereich „Produkt hinzufügen".
2. Suchen Sie das „WhatsApp"-Produkt und klicken Sie auf „Einrichten".
3. Bestätigen Sie das zu verknüpfende Meta Business-Konto.

Schritt 5: Telefonnummer-ID abrufen

1. Gehen Sie im linken Menü zu WhatsApp → Konfiguration.
2. Kopieren Sie den Wert „Telefonnummer-ID" (Phone Number ID).
3. Fügen Sie diesen Wert in das Feld „Telefonnummer-ID" im Convord-Panel ein.

Schritt 6: Zugangstoken abrufen

1. Gehen Sie im linken Menü zu WhatsApp → API-Einrichtung.
2. Kopieren Sie das Token aus dem Bereich „Temporäres Zugangstoken" (Temporary Access Token).
3. Fügen Sie diesen Wert in das Feld „Zugangstoken" im Convord-Panel ein.

Schritt 7: Webhook-Konfiguration

1. Gehen Sie im linken Menü zu WhatsApp → Konfiguration.
2. Klicken Sie im Bereich „Webhook" auf „Bearbeiten".
3. Geben Sie die Webhook-URL aus dem Convord-Panel als Callback-URL ein:
   https://ihre-domain.com/webhook/whatsapp
4. Geben Sie den WHATSAPP_VERIFY_TOKEN-Wert aus Ihrer .env-Datei als Verify Token ein.
5. Klicken Sie auf „Verifizieren und speichern".

Schritt 8: Webhook-Felder abonnieren

Abonnieren Sie im Bereich „Webhook-Felder" unter der Webhook-Konfiguration das Feld messages (✓ Häkchen).

Schritt 9: Testen

1. Senden Sie eine Testnachricht an Ihre WhatsApp-Nummer (z. B. „2 Kisten Cola, 1 Kiste Wasser").
2. Überprüfen Sie den Bereich Bestellungen im Convord-Panel.
3. Wurde Ihre Nachricht automatisch in eine Bestellung umgewandelt, ist die Integration erfolgreich!

2. Abrechnung / e-Rechnung-Integration

Abrechnungsfunktion aktivieren

1. Aktivieren Sie auf der Integrationsseite den Schalter im Bereich Abrechnung.
2. Wählen Sie Ihre Rechnungserstellungsmethode:
   • Systemrechnung: Erstellt Rechnungen mit der eigenen PDF-Vorlage von Convord.
   • Uyumsoft: Stellt GİB-konforme e-Rechnungen und e-Archiv-Rechnungen aus.

Allgemeine Rechnungsinformationen

Uyumsoft e-Rechnung-Einrichtung

1. Erwerben Sie den e-Rechnung/e-Archiv-Service unter uyumsoft.com.
2. Nach der Aktivierung Ihres Kontos erhalten Sie Ihre API-Zugangsdaten.
3. Wählen Sie „Uyumsoft" als Rechnungserstellungsmethode.
4. Geben Sie den von Uyumsoft bereitgestellten Benutzernamen und das Passwort ein.
5. Klicken Sie auf Speichern.

3. Telegram-Benachrichtigungen

Die Telegram-Integration ermöglicht es Ihnen, sofortige Benachrichtigungen über neue Bestellungen und wichtige Ereignisse zu erhalten.

Erforderliche Informationen

Schritt 1: Telegram-Bot erstellen

1. Suchen Sie in Telegram den Bot @BotFather und starten Sie eine Unterhaltung.
2. Senden Sie den Befehl /newbot.
3. Geben Sie Ihrem Bot einen Namen (z. B. „Convord Benachrichtigung").
4. Geben Sie Ihrem Bot einen Benutzernamen (z. B. convord_notify_bot).
5. BotFather stellt Ihnen ein Bot-Token zur Verfügung. Kopieren Sie diesen Wert.

Schritt 2: Bot-Token eingeben

1. Gehen Sie im Convord-Panel zur Seite Integrationen.
2. Fügen Sie das Token in das Feld „Bot-Token" im Telegram-Bereich ein.

Schritt 3: Chat-ID finden

Für persönliche Chat-ID:

1. Suchen Sie in Telegram den Bot @userinfobot oder @RawDataBot.
2. Senden Sie /start an den Bot.
3. Kopieren Sie den Chat-ID-Wert aus der zurückgegebenen Nachricht.

Für Gruppen-Chat-ID:

1. Fügen Sie Ihren Bot zu einer Telegram-Gruppe hinzu.
2. Senden Sie eine Nachricht in der Gruppe.
3. Öffnen Sie die folgende URL in Ihrem Browser:
   https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
4. Finden Sie den Wert "chat":{"id":-100XXXXXXXXXX} im zurückgegebenen JSON.

Schritt 4: Chat-ID eingeben und testen

1. Fügen Sie die Chat-ID in das Feld „Chat-ID" im Convord-Panel ein.
2. Klicken Sie auf Speichern.
3. Erstellen Sie eine neue Bestellung und prüfen Sie, ob eine Benachrichtigung über Telegram eintrifft.

4. Fehlerbehebung

5. Sicherheitsempfehlungen

• Teilen Sie Ihre API-Schlüssel niemals mit Dritten.
• Erneuern Sie ein dauerhaftes WhatsApp-Token regelmäßig.
• Wenn Ihr Telegram-Bot-Token kompromittiert wurde, widerrufen Sie es über BotFather mit dem Befehl /revoke.
• Bewahren Sie Ihre Uyumsoft-API-Zugangsdaten in einer sicheren Umgebung auf.
• Ändern Sie Ihr Plattform-Kontopasswort regelmäßig und verwenden Sie ein sicheres Passwort.

6. Support

Wenn Sie Hilfe bei der Integrationseinrichtung benötigen:

• E-Mail: destek@convord.com
• Telefon: +90 XXX XXX XX XX
• Betreff: „Integrations-Support – [WhatsApp/Telegram/e-Rechnung]"