Zum Hauptinhalt springen

💬 Viber

PulseHub verbindet sich über die Viber REST API mit Viber, unter Verwendung eines Viber Public Account oder Viber Bot.

Voraussetzungen​

Ein Viber Partners-Konto bei partners.viber.com.

Einrichtungsschritte​

1. Viber Bot/Public Account erstellen​

  1. Gehen Sie zu partners.viber.com
  2. Melden Sie sich mit Ihrem Viber-Konto an
  3. Klicken Sie auf Create Bot Account
  4. Füllen Sie Bot-Name, Beschreibung und Kategorie aus
  5. Nach der Erstellung erhalten Sie ein Auth Token

2. Kanal in PulseHub hinzufügen​

  1. Gehen Sie zu Kanäle → Kanal hinzufügen
  2. Wählen Sie Viber
  3. Geben Sie Auth Token und Bot-Name ein
  4. Klicken Sie auf Kanal speichern
  5. Kopieren Sie die Webhook-URL

3. Webhook registrieren​

Option A — Mit einem Online-Tool (kein Terminal nötig): Verwenden Sie einen kostenlosen Online-REST-Client (z.B. Reqbin, Hoppscotch oder Postman Web) und senden Sie eine POST-Anfrage:

  • URL: https://chatapi.viber.com/pa/set_webhook
  • Header: Content-Type: application/json
  • Body:
{
    "auth_token": "IHR_VIBER_AUTH_TOKEN",
    "url": "https://ihredomain.com/webhooks/viber/IHRE_KANAL_ID",
    "event_types": ["message", "subscribed", "unsubscribed", "conversation_started"]
}

Option B — Mit Terminal (VPS):

curl -X POST https://chatapi.viber.com/pa/set_webhook \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "IHR_VIBER_AUTH_TOKEN",
    "url": "https://ihredomain.com/webhooks/viber/IHRE_KANAL_ID",
    "event_types": ["message", "subscribed", "unsubscribed", "conversation_started"]
  }'

4. Testen​

Öffnen Sie Ihren Viber-Bot in der App und senden Sie eine Nachricht. Sie sollte in PulseHub innerhalb von Sekunden erscheinen.

Signaturverifizierung​

Viber signiert jeden Webhook mit X-Viber-Content-Signature unter Verwendung von HMAC-SHA256 mit Ihrem Auth Token.