Quickstart

In 5 Minuten deine erste Aktion an Venturo senden.

1. API Key erstellen

Im Venturo Dashboard unter Connector → API Keys einen neuen Key anlegen.

vt_live_xxxxxxxxxxxxxxxxxxxx

2. PHP SDK installieren

composer require venturo/connector-php

3. Erste Aktion senden

use Venturo\Connector\Client;

$venturo = new Client(
    apiKey: 'vt_live_xxxx',
    companyId: 'comp_abc'
);

$result = $venturo->actions()->send('customer.created', [
    'name'   => 'Max Mustermann',
    'email'  => 'max@example.com',
    'plan'   => 'starter',
    'source' => 'organic',
]);

echo $result['created']['id']; // Sim-Customer-ID

4. Webhook registrieren

$venturo->webhooks()->register(
    url: 'https://myapp.com/webhooks/venturo',
    events: ['customer.churned', 'finance.low_balance'],
    secret: 'whsec_xxxx'
);

5. Webhook in deiner App empfangen

$event = $venturo->webhooks()->verify(
    rawBody: file_get_contents('php://input'),
    signature: $_SERVER['HTTP_X_VENTURO_SIGNATURE']
);

if ($event['type'] === 'customer.churned') {
    // Kündigung in deiner App verarbeiten
    handleChurn($event['data']['customer_id']);
}

TIP

Nutze vt_test_ Keys für die Entwicklung — Test-Events beeinflussen die Simulation nicht.