​

Voraussetzungen

• Ein telli-Konto mit API-Zugang
• Ein CRM-System (z. B. Airtable, Salesforce, HubSpot, Pipedrive) oder eine Automatisierungsplattform (Zapier, Make, n8n)
• Eine Webhook-Endpoint-URL von deinem CRM oder deiner Automatisierungsplattform

​

Einrichtung zum Empfang von Anrufdaten in deinem CRM

​

Webhooks für dein CRM einrichten

1. Erstelle in deinem CRM oder deiner Automatisierungsplattform (Zapier, Make, n8n) einen Webhook-Endpoint und kopiere die URL
2. Gehe in telli zu Einstellungen > Entwickler und klicke unter „Webhook-Konfiguration“ auf „Konfigurieren“
3. Klicke auf “Add Endpoint” und füge die Webhook-URL deines CRMs ein
4. Aktiviere die Events, die du empfangen möchtest (z. B. “call_ended”, um CRM-Einträge zu aktualisieren, wenn Anrufe abgeschlossen sind)
5. Führe einen Testanruf mit deinem telli-Konto durch
6. Überprüfe, ob der Webhook ausgelöst wurde und dein CRM-Eintrag automatisch aktualisiert wurde

So fügst du einen Endpoint hinzu

Um dein CRM mit telli zu verbinden, musst du einen Webhook-Endpoint konfigurieren. Das ist die URL, an die telli Anrufdaten sendet, um deine CRM-Einträge zu aktualisieren.Gehe in telli zu Einstellungen > Entwickler und klicke unter „Webhook-Konfiguration“ auf „Konfigurieren“, um das Webhook-Portal aufzurufen.Klicke auf “Add Endpoint”, um die Webhook-URL deines CRMs hinzuzufügen. Füge die URL von deinem CRM oder deiner Automatisierungsplattform ein und klicke auf “Add”.Du kannst nun die Events aktivieren, die du empfangen möchtest (z. B. “call_ended”), um dein CRM automatisch zu aktualisieren, wenn Anrufe abgeschlossen sind.

​

Events

• call_ended: Wird ausgelöst, wenn ein Anruf abgeschlossen ist, einschließlich Transkript und Analyse
• auto_dialer_status_changed: Wird ausgelöst, wenn ein Kontakt den Auto-Dialer betritt oder verlässt
• contact_status_changed: Veraltetes Kontaktstatus-Event; wird am 1. Juli 2027 entfernt

​

Call Ended Event

• state: wo sich der Anruf in seinem Lebenszyklus befindet. Einer von queued, ringing, in_progress oder ended.
• status: was passiert ist, nachdem der Anruf beendet wurde. null, bis der Anruf beendet ist, dann einer von:
  • connected: ein Gespräch mit dem Kontakt hat stattgefunden
  • not_connected: wir konnten den Kontakt nicht erreichen
  • voicemail: wir haben die Mailbox des Kontakts erreicht
  • failed: ein Fehler ist während des Anrufs aufgetreten
• follow_up: der von telli aus dem Anruf geplante Folgeanruf oder null, wenn keiner geplant wurde. Wenn vorhanden, lautet es { "type": "agent_follow_up", "scheduled_at": "<ISO-Zeitstempel>" }.

• COMPLETED: Ein Gespräch mit dem Kontakt hat stattgefunden
• ANSWERED: Ein Anruf hat stattgefunden, aber ein weiterer Versuch wird unternommen, den Kontakt zu erreichen
• NOT_REACHED: Wir konnten den Kontakt nicht erreichen
• VOICEMAIL: Wir haben die Mailbox des Kontakts erreicht
• ERROR: Ein Fehler ist beim Anruf aufgetreten

• call_outcome: Benutzerdefinierte Anrufanalyse-Felder, die du in der telli-App konfigurieren kannst
  {
    "custom_lost_reason": {             // call analysis field name
      "value": "PRODUCT_TOO_EXPENSIVE", // call analysis value
      "fieldSchema": ...                // information about schema
    }
  }
  
• call_analysis: Vom System bereitgestellte Anrufanalyse-Felder Beachte, dass das call_analysis-Format sich vom call_outcome-Format unterscheidet:
  {
    "appointment": {
      "value": true,                     // boolean: is the value present?
      "details": "2025-02-18T15:30:00Z", // additional details (string or number)
    }
  }
  

{
  "email": {
    "status": "confirmed",
    "value": "[email protected]"
  },
  "case_number": {
    "status": "declined",
    "value": null
  }
}

• status: "confirmed" | "declined" | "error" | "in_progress"
• value: der erfasste String, oder null wenn nicht erfasst

{
  "event": "call_ended",
  "call": {
    "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c",
    "attempt": 1,
    "booked_slot_for": "2025-02-24T15:30:00Z",
    "call_analysis": {
      "appointment": {
        "details": "2025-02-18T15:30:00Z",
        "value": true
      },
      "interest": {
        "details": "The customer is interested in buying an ice cream machine",
        "value": true
      },
      "summary": {
        "details": "A call between an agent and a customer talking about buying an ice cream machine",
        "value": true
      }
    },
    "call_id": "b4a05730-2abc-4eb0-8066-2e4d23b53ba9",
    "call_length_min": 2,
    "call_outcome": {
      "custom_lost_reason": {
        "fieldSchema": {
          "enum": [
            "CUSTOMER_NOT_INTERESTED",
            "CUSTOMER_PREVIOUSLY_CONTACTED",
            "PRODUCT_TOO_EXPENSIVE"
          ],
          "type": ["string", "null"]
        },
        "value": "PRODUCT_TOO_EXPENSIVE"
      }
    },
    "call_status": "COMPLETED",
    "state": "ended",
    "status": "connected",
    "follow_up": null,
    "collected_data": {
      "email": {
        "status": "confirmed",
        "value": "[email protected]"
      }
    },
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "direction": "outbound",
    "ended_at": 1731957002078,
    "external_contact_id": "external-123",
    "from_number": "+17755719467",
    "loop_id": "ba99c99d-19b9-4a0d-8df6-3e213088989a",
    "recording_url": "<url-of-recording>",
    "sip_status_code": 200,
    "sip_status": "OK",
    "started_at": 1731956932264,
    "to_number": "+16506794960",
    "transfer": null,
    "transcript": "Agent: Hello...",
    "transcriptObject": [
      {
        "content": "Hello...",
        "role": "agent"
      }
    ],
    "triggered_at": 1731956924302
  },
  "contact": {
    "call_attempts": 1,
    "contact_details": {
      "company": "Art Studio Inc",
      "notes": "Interested in solar panels"
    },
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "created_at": "2024-11-18T15:30:00.000Z",
    "email": "[email protected]",
    "external_contact_id": "external-123",
    "first_name": "Frida",
    "in_call_since": null,
    "last_name": "Kahlo",
    "next_call_at": null,
    "phone_number": "+14155552671",
    "reached_at": "2024-11-18T15:45:00.000Z",
    "salutation": "Ms.",
    "status": "reached",
    "timezone": "America/Los_Angeles"
  }
}

​

Contact Status Changed Event

​

Kontaktstatus

• new: Kontakt wurde noch nicht angerufen
• pending: Kontakt ist im Dialer und wir versuchen, ihn zu erreichen
• closed: Dialer wurde ausgeschöpft und wir versuchen nicht mehr, den Kontakt anzurufen
• reached: Kontakt wurde erreicht und ein Gespräch hat stattgefunden. Wir versuchen nicht mehr, ihn anzurufen

{
  "event": "contact_status_changed",
  "contact": {
    "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
    "external_contact_id": "external-123",
    "status": "reached",
    "status_updated_at": "2024-03-18T15:30:00Z",
    "reached_at": "2024-03-18T15:30:00Z",
    "first_name": "Frida",
    "last_name": "Kahlo",
    "phone_number": "+14155552671",
    "email": "[email protected]"
  }
}

​

Sicherheit und Zuverlässigkeit

​

Signaturen verifizieren

import { Webhook } from "svix";

// You can get this secret from the Webhook Configuration in the telli dashboard
const secret = "whsec_GET_THIS_FROM_THE_DASHBOARD";

// These were all sent from the server
const headers = {
  "svix-id": "msg_p5jXN8AQM9LWM0D4loKWxJek",
  "svix-timestamp": "1614265330",
  "svix-signature": "v1,g0hM9SsE+OTPJTGt/tmIKtSyZlE3uFJELVlNIOLJ1OE=",
};
const payload = '{"test": 2432232314}';

const wh = new Webhook(secret);
// Throws on error, returns the verified content on success
const payload = wh.verify(payload, headers);

Hinweis: Deaktiviere den CSRF-Schutz für deinen Endpoint, um Webhook-POST-Anfragen zuzulassen