Zum Hauptinhalt springen

​
Voraussetzungen

  • Ein telli-Konto mit API-Zugang
  • Ein API-Key aus deinem telli-Dashboard (Einstellungen > API & Webhooks)
  • Ein CRM-System, eine Datenbank oder eine Automatisierungsplattform (Zapier, Make, n8n) mit zu synchronisierenden Kontakten
  • Kontaktdaten bestehend aus: Vorname, Nachname und Telefonnummer (E-Mail und Zeitzone sind optional)
Du kannst Kontakte programmatisch über die API zu telli hinzufügen, um eine nahtlose Integration mit deinem CRM, deiner Datenbank oder anderen Systemen zu ermöglichen.

​
Einzelnen Kontakt hinzufügen

Füge einen einzelnen Kontakt über den /v1/add-contact-Endpoint hinzu: 
POST /v1/add-contact

{
  "external_contact_id": "crm-12345",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "+14155552671",
  "email": "[email protected]",
  "timezone": "America/New_York",
  "contact_details": {
    "company": "Acme Corp",
    "notes": "Interested in product demo"
  }
}
Siehe die Add Contact Endpoint-Dokumentation für vollständige Details.

​
Mehrere Kontakte hinzufügen (Batch)

Füge mehrere Kontakte effizient über den /v1/add-contacts-batch-Endpoint hinzu: 
POST /v1/add-contacts-batch

{
  "contacts": [
    {
      "external_contact_id": "crm-12345",
      "first_name": "John",
      "last_name": "Doe",
      "phone_number": "+14155552671",
      "email": "[email protected]"
    },
    {
      "external_contact_id": "crm-12346",
      "first_name": "Jane",
      "last_name": "Smith",
      "phone_number": "+14155552672",
      "email": "[email protected]"
    }
  ]
}
Siehe die Add Contacts (Batch) Endpoint-Dokumentation für vollständige Details.

​
Einzelnen Anruf planen

Nach dem Hinzufügen eines Kontakts kannst du einen Anruf mit der contact_id aus der Antwort planen. Verwende den /v1/schedule-call-Endpoint: 
POST /v1/schedule-call

{
  "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
  "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c"
}
Siehe die Schedule Call Endpoint-Dokumentation für vollständige Details.

​
Mehrere Anrufe planen (Batch)

Plane Anrufe für mehrere Kontakte gleichzeitig über den /v1/schedule-calls-batch-Endpoint: 
POST /v1/schedule-calls-batch

{
  "contacts": [
    {
      "contact_id": "6bd1e7e0-6d00-4c0b-ad5b-daa72457a27d",
      "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c"
    },
    {
      "contact_id": "7ce2e8f1-7e11-5d1c-be6c-ebb83568b38e",
      "agent_id": "d8931604-92ad-45cf-9071-d9cd2afbad0c"
    }
  ]
}
Siehe die Schedule Calls (Batch) Endpoint-Dokumentation für vollständige Details.

​
Best Practices

  1. Verwende external_contact_id: Gib immer die Kontakt-ID deines CRMs an, um die Zuordnung beizubehalten
  2. Batch wenn möglich: Nutze Batch-Endpoints für den Import mehrerer Kontakte und die Planung von Anrufen
  3. Fehler behandeln: Prüfe die Antwort auf fehlgeschlagene Kontakte bei Batch-Operationen
  4. contact_id speichern: Speichere die zurückgegebene contact_id, um telli-Kontakte mit deinem System zu verknüpfen und Anrufe zu planen
  5. Nach dem Hinzufügen planen: Plane nach dem Hinzufügen von Kontakten sofort Anrufe mit der zurückgegebenen contact_id, um deinen Workflow zu automatisieren