Kontakte

curl -X POST "https://app.talkturo.com/api/crm/contacts" \
  -H "Authorization: Bearer tk_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "cmp_7f3c2a91",
    "firstName": "Maya",
    "lastName": "Patel",
    "phone": "+14155550182",
    "email": "maya.patel@northstar.io",
    "leadStatus": "qualified",
    "source": "webinar",
    "timezone": "America/Los_Angeles",
    "tags": ["enterprise", "west-region"],
    "customFields": {
      "productInterest": "voice automation",
      "employeeCount": 120
    }
  }'

const response = await fetch("https://app.talkturo.com/api/crm/contacts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer tk_example_9xmk7q2r",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    companyId: "cmp_7f3c2a91",
    firstName: "Maya",
    lastName: "Patel",
    phone: "+14155550182",
    email: "maya.patel@northstar.io",
    leadStatus: "qualified",
    source: "webinar",
    timezone: "America/Los_Angeles",
    tags: ["enterprise", "west-region"],
    customFields: {
      productInterest: "voice automation",
      employeeCount: 120
    }
  })
});
const data = await response.json();
console.log(data);

{
  "id": "ctc_a1b2c3d4",
  "companyId": "cmp_7f3c2a91",
  "firstName": "Maya",
  "lastName": "Patel",
  "phone": "+14155550182",
  "email": "maya.patel@northstar.io",
  "leadStatus": "qualified",
  "source": "webinar",
  "timezone": "America/Los_Angeles",
  "doNotCall": false,
  "tags": ["enterprise", "west-region"],
  "customFields": {
    "productInterest": "voice automation",
    "employeeCount": 120
  }
}

{
  "error": "Validation failed",
  "details": {
    "phone": "Phone must be in E.164 format"
  }
}

{
  "error": "Company does not belong to this workspace"
}

curl -X POST "https://app.talkturo.com/api/crm/contacts" \
  -H "Authorization: Bearer tk_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "cmp_7f3c2a91",
    "firstName": "Daniel",
    "lastName": "Ruiz",
    "phone": "+12125550149",
    "campaignId": "cam_4820af31",
    "campaignPriority": 90
  }'

{
  "id": "ctc_g7h8i9j0",
  "firstName": "Daniel",
  "lastName": "Ruiz",
  "phone": "+12125550149",
  "companyId": "cmp_7f3c2a91",
  "campaignEnrollment": {
    "campaignId": "cam_4820af31",
    "status": "pending",
    "priority": 90
  }
}

curl -G "https://app.talkturo.com/api/crm/contacts" \
  -H "Authorization: Bearer tk_example_9xmk7q2r" \
  --data-urlencode "search=maya" \
  --data-urlencode "companyId=cmp_7f3c2a91" \
  --data-urlencode "leadStatus=qualified" \
  --data-urlencode "doNotCall=false" \
  --data-urlencode "hasPhone=true" \
  --data-urlencode "limit=25" \
  --data-urlencode "offset=0"

{
  "data": [
    {
      "id": "ctc_a1b2c3d4",
      "firstName": "Maya",
      "lastName": "Patel",
      "phone": "+14155550182",
      "email": "maya.patel@northstar.io",
      "leadStatus": "qualified",
      "doNotCall": false,
      "companyId": "cmp_7f3c2a91"
    }
  ],
  "limit": 25,
  "offset": 0
}

curl -X PUT "https://app.talkturo.com/api/crm/contacts/ctc_a1b2c3d4" \
  -H "Authorization: Bearer tk_example_9xmk7q2r" \
  -H "Content-Type: application/json" \
  -d '{
    "leadStatus": "customer",
    "jobTitle": "Operations Director",
    "doNotCall": true,
    "customFields": {
      "implementationStage": "contract-sent"
    }
  }'

{
  "id": "ctc_a1b2c3d4",
  "leadStatus": "customer",
  "jobTitle": "Operations Director",
  "doNotCall": true,
  "customFields": {
    "implementationStage": "contract-sent"
  }
}

curl -X DELETE "https://app.talkturo.com/api/crm/contacts/ctc_a1b2c3d4" \
  -H "Authorization: Bearer tk_example_9xmk7q2r"

{
  "success": true
}

{
  "error": "Contact is enrolled in an active campaign"
}

Kontaktdaten an einem Ort verwalten

Kontakte sind die Personen, die deine Assistenten anrufen, und die Personen, die deine Assistenten anrufen. Jeder Kontaktdatensatz speichert persönliche Details, Lead-Status, die Beziehung zum Unternehmen und benutzerdefinierte Felder, die Talkturo verwendet, um Gespräche zu personalisieren, Aktivitäten nachzuverfolgen und den Wählvorgang für Kampagnen zu unterstützen.

Ein vollständiger Kontaktdatensatz macht nachgelagerte Workflows zuverlässiger. Wenn Telefonnummern, Unternehmensverknüpfungen und Lead-Daten korrekt sind, können Assistenten Anrufe richtig weiterleiten, CRM-Datensätze nach Gesprächen aktualisieren und vermeiden, Kontakte anzurufen, die ausgeschlossen werden sollten.

Kontaktfelder

Verwende diese Felder, wenn du Kontakte erstellst, importierst oder aktualisierst.

Kontakte erstellen

Erstelle Kontakte entweder einzeln im Dashboard oder programmgesteuert über die API. In beiden Fällen sind die mindestens erforderlichen Felder companyId, firstName, lastName und phone.

Einen Kontakt im Dashboard erstellen

Einen Kontakt über die API erstellen

Einen Kontakt bei der Erstellung in einer Kampagne anmelden

Du kannst einen Kontakt bei der Erstellung anmelden, indem du campaignId und campaignPriority in die Anfrage aufnimmst. Das ist nützlich, wenn importierte oder synchronisierte Kontakte sofort mit dem Wählvorgang beginnen sollen.

Wenn der Kontakt als do not call markiert ist, erstellt die Kampagnenanmeldung keinen wählbaren Datensatz mit dem Status pending. Stattdessen setzt Talkturo den Kampagnenstatus auf skipped.

Kontakte aus CSV importieren

Verwende den CSV-Import, wenn du eine große Liste von Kontakten auf einmal hinzufügen musst. Der Importablauf unterstützt Spaltenzuordnung, Validierung und Deduplizierung, bevor Datensätze erstellt werden.

Was der CSV-Import übernimmt

• Spaltenzuordnung zu standardmäßigen Talkturo-Kontaktfeldern
• Zuordnung benutzerdefinierter Felder für Workspace-spezifische Daten
• Validierung für erforderliche Felder und Telefonnummernformatierung
• Deduplizierung zur Reduzierung doppelter Kontakte

Kontakte suchen und filtern

Verwende Filter, um große Kontaktlisten einzugrenzen, bevor du Kontakte bearbeitest, exportierst oder in Kampagnen anmeldest.

Die Suche verwendet Groß-/Kleinschreibung-unabhängige Übereinstimmung für Namens-, E-Mail- und Telefonnummernfelder. Die Paginierung verwendet limit und offset, wodurch sich inkrementelle Sync-Jobs leicht aufbauen oder große Ergebnismengen im Dashboard durchblättern lassen.

Bestehende Kontakte verwalten

Nachdem ein Kontakt existiert, kannst du den vollständigen Datensatz abrufen, CRM-Daten aktualisieren oder den Kontakt entfernen, sofern keine aktive Kampagne davon abhängt.

Kontakt-Endpunkte

Einen Kontaktdatensatz anzeigen

GET /api/crm/contacts/[id] gibt den Kontakt zusammen mit zugehörigem CRM-Kontext zurück. Verwende das, wenn du einen vollständigen Datensatz für Agent-Tools, interne Dashboards oder Synchronisierungslogik benötigst.

Die Detailansicht enthält zugehörige Aktivitäten, Opportunities und den Kampagnenverlauf. Dieser Verlauf hilft dir zu verstehen, was bei früheren Anrufen passiert ist und ob ein Kontakt bereits Teil einer laufenden Outreach-Maßnahme ist.

Einen Kontakt aktualisieren

Verwende PUT /api/crm/contacts/[id], um Standardfelder, benutzerdefinierte Felder, Tags, Lead-Status oder das do not call-Flag zu ändern.

Einen Kontakt löschen

Verwende DELETE /api/crm/contacts/[id], um einen Datensatz zu entfernen, der nicht mehr benötigt wird.

Do not call-Verhalten

Setze doNotCall für jeden Kontakt, der niemals von Kampagnen gewählt werden soll. Dieses Flag wird auf mehreren Ebenen durchgesetzt, sodass ausgeschlossene Kontakte nicht über Importe, Aktualisierungen oder Kampagnenanmeldung erneut in Warteschlangen für den Wählvorgang gelangen.

Der DNC-Status ist nützlich für Compliance, manuelle Unterdrückung und die Kontrolle der Lead-Qualität. Du kannst ihn in einzelnen Kontaktdatensätzen aktualisieren und per Filter prüfen, welche Kontakte aktuell unterdrückt sind.

Kampagnenanmeldung und Verlauf

Kontakte können Kampagnen beitreten, wenn du sie erstellst, oder später über die Seite für Kampagnenkontakte. Die Priorität steuert die Reihenfolge des Wählvorgangs, wobei höhere Werte früher gewählt werden.

Der Kampagnenverlauf erscheint in der Detailansicht des Kontakts. Nutze diesen Verlauf, um zu prüfen, ob ein Kontakt in die Warteschlange gestellt, übersprungen, kontaktiert oder von früherem Outreach verarbeitet wurde.

KI-Datenextraktion und Aktivitätsprotokollierung

Talkturo kann strukturierte Daten aus Anruftranskripten extrahieren und sie zurück in den Kontaktdatensatz schreiben. Dazu gehören Standard-CRM-Felder und customFields, sodass Assistenten Informationen erfassen können, ohne dass von Anfang an ein vollständig starres Schema erforderlich ist.

Jede extrahierte Aktualisierung ist mit einer CRM-Aktivität verknüpft. Kontaktdatensätze können protokollierte Anrufaktivitäten mit Aktivitätstyp, Betreff und Ergebnis enthalten, wodurch dein Team nachvollziehen kann, was passiert ist und warum Felder geändert wurden.

Ein vollständiger Kontaktdatensatz wird mit der Zeit wertvoller. Während Assistenten mehr Anrufe verarbeiten, bilden extrahierte Daten, Kampagnenverlauf und zugehörige Opportunities einen klareren Datensatz für Sales- und Support-Teams.

Verwandte Seiten