CRMCRM-Kontakte

CRM-Kontakte

Kontakte erstellen, auflisten, aktualisieren, löschen und importieren im Talkturo-CRM — Kundendaten mit Filterung, Paginierung und benutzerdefinierten Feldern verwalten.

curl -X GET "https://app.talkturo.com/api/crm/contacts?page=1&limit=25&search=Jane&companyId=cmp_42&campaignId=camp_17" \
  -H "Cookie: sb-session=example_session_cookie"

{
  "success": true,
  "contacts": [
    {
      "id": "ctc_8f3a21",
      "first_name": "Jane",
      "last_name": "Chen",
      "email": "jane.chen@northstar.io",
      "phone": "+14155550189",
      "company_id": "cmp_42"
    }
  ],
  "total": 1,
  "page": 1
}

curl -X POST "https://app.talkturo.com/api/crm/contacts" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-session=example_session_cookie" \
  -d '{
    "first_name": "Jane",
    "last_name": "Chen",
    "email": "jane.chen@northstar.io",
    "phone": "+14155550189",
    "company_id": "cmp_42"
  }'

{
  "success": true,
  "contact": {
    "id": "ctc_8f3a21",
    "first_name": "Jane",
    "last_name": "Chen",
    "email": "jane.chen@northstar.io",
    "phone": "+14155550189",
    "company_id": "cmp_42"
  }
}

curl -X GET "https://app.talkturo.com/api/crm/contacts/ctc_8f3a21" \
  -H "Cookie: sb-session=example_session_cookie"

{
  "success": true,
  "contact": {
    "id": "ctc_8f3a21",
    "first_name": "Jane",
    "last_name": "Chen",
    "email": "jane.chen@northstar.io",
    "phone": "+14155550189",
    "company_id": "cmp_42"
  }
}

curl -X PATCH "https://app.talkturo.com/api/crm/contacts/ctc_8f3a21" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-session=example_session_cookie" \
  -d '{
    "phone": "+14155550190",
    "company_id": "cmp_84"
  }'

{
  "success": true,
  "contact": {
    "id": "ctc_8f3a21",
    "first_name": "Jane",
    "last_name": "Chen",
    "email": "jane.chen@northstar.io",
    "phone": "+14155550190",
    "company_id": "cmp_84"
  }
}

curl -X DELETE "https://app.talkturo.com/api/crm/contacts/ctc_8f3a21" \
  -H "Cookie: sb-session=example_session_cookie"

{
  "success": true
}

curl -X POST "https://app.talkturo.com/api/crm/contacts/import" \
  -H "Content-Type: application/json" \
  -H "Cookie: sb-session=example_session_cookie" \
  -d '{
    "contacts": [
      {
        "first_name": "Jane",
        "last_name": "Chen",
        "email": "jane.chen@northstar.io",
        "phone": "+14155550189",
        "company_id": "cmp_42"
      },
      {
        "first_name": "Marcus",
        "last_name": "Rivera",
        "email": "marcus.rivera@northstar.io",
        "phone": "+14155550192",
        "company_id": "cmp_42"
      }
    ]
  }'

{
  "success": true,
  "imported": 2,
  "failed": 0,
  "errors": []
}

CRM-Kontakte im Talkturo-CRM verwalten

Mit den CRM-Kontakt-Endpunkten verwalten Sie Ihre Kontaktdaten zentral im Talkturo-CRM. Sie können Kontakte auflisten, einzelne Datensätze anlegen, bestehende Kontakte aktualisieren, löschen und größere Datenmengen gesammelt importieren.

Alle Endpunkte in diesem Bereich sind für browserbasierte Sitzungen ausgelegt. Wenn Sie mit diesen Routen arbeiten, muss die Anfrage eine gültige Session-Cookie-Authentifizierung enthalten.

Diese Endpunkte akzeptieren laut Implementierung nur Session-Authentifizierung. API-Keys oder Bearer-Token sind für CRM-Kontakte nicht vorgesehen.

Endpunktübersicht

MethodePfadZweck
GET/api/crm/contactsKontakte auflisten
POST/api/crm/contactsKontakt erstellen
GET/api/crm/contacts/{id}Einzelnen Kontakt abrufen
PATCH/api/crm/contacts/{id}Kontakt aktualisieren
DELETE/api/crm/contacts/{id}Kontakt löschen
POST/api/crm/contacts/importKontakte gesammelt importieren

Kontakte auflisten

Rufen Sie GET /api/crm/contacts auf, um Kontakte seitenweise abzurufen und die Ergebnismenge nach Suchbegriff, Unternehmen oder Kampagne zu filtern.

Query-Parameter

query
pageinteger

Seitennummer der Ergebnisliste.

query
limitinteger

Maximale Anzahl von Kontakten pro Seite.

query
companyIdstring

Filtert Kontakte nach einer bestimmten Unternehmens-ID.

query
campaignIdstring

Filtert Kontakte nach einer bestimmten Kampagnen-ID.

Antwortfelder

successboolean
Required

Kennzeichnet eine erfolgreiche Anfrage.

contactsarray
Required

Liste der gefundenen Kontakte für die angeforderte Seite.

idstring
Required

Eindeutige ID des Kontakts.

first_namestring
Required

Vorname des Kontakts.

last_namestring
Required

Nachname des Kontakts.

emailstring

E-Mail-Adresse des Kontakts, sofern vorhanden.

phonestring

Telefonnummer des Kontakts, sofern vorhanden.

company_idstring

ID des zugeordneten Unternehmens, sofern gesetzt.

totalinteger
Required

Gesamtzahl aller Treffer über alle Seiten hinweg.

pageinteger
Required

Aktuelle Seite der Antwort.

Kontakt erstellen

Rufen Sie POST /api/crm/contacts auf, um einen neuen Kontakt im CRM anzulegen.

Request-Body

body
first_namestring
Required

Vorname des Kontakts.

body
last_namestring
Required

Nachname des Kontakts.

body
emailstring

E-Mail-Adresse des Kontakts.

body
phonestring

Telefonnummer des Kontakts.

body
company_idstring

ID des Unternehmens, dem Sie den Kontakt zuordnen möchten.

Antwortfelder

successboolean
Required

Kennzeichnet eine erfolgreiche Erstellung.

contactobject
Required

Neu angelegter Kontaktdatensatz.

idstring
Required

Eindeutige ID des neu angelegten Kontakts.

first_namestring
Required

Vorname des Kontakts.

last_namestring
Required

Nachname des Kontakts.

emailstring

E-Mail-Adresse des Kontakts, sofern übergeben.

phonestring

Telefonnummer des Kontakts, sofern übergeben.

company_idstring

ID des verknüpften Unternehmens, sofern gesetzt.

Einzelnen Kontakt abrufen

Rufen Sie GET /api/crm/contacts/{id} auf, um einen einzelnen Kontakt anhand seiner ID zu laden.

Pfadparameter

path
idstring
Required

Eindeutige ID des Kontakts, den Sie abrufen möchten.

Antwortfelder

successboolean
Required

Kennzeichnet eine erfolgreiche Anfrage.

contactobject
Required

Der angeforderte Kontakt.

Kontakt aktualisieren

Rufen Sie PATCH /api/crm/contacts/{id} auf, um einen bestehenden Kontakt teilweise zu aktualisieren. Sie können nur die Felder senden, die sich ändern sollen.

Pfadparameter

path
idstring
Required

Eindeutige ID des Kontakts, den Sie aktualisieren möchten.

Aktualisierbare Felder

body
first_namestring

Aktualisierter Vorname des Kontakts.

body
last_namestring

Aktualisierter Nachname des Kontakts.

body
emailstring

Aktualisierte E-Mail-Adresse.

body
phonestring

Aktualisierte Telefonnummer.

body
company_idstring

Aktualisierte Unternehmenszuordnung.

Antwortfelder

successboolean
Required

Kennzeichnet eine erfolgreiche Aktualisierung.

contactobject
Required

Der aktualisierte Kontaktdatensatz.

Kontakt löschen

Rufen Sie DELETE /api/crm/contacts/{id} auf, um einen Kontakt dauerhaft zu entfernen.

Pfadparameter

path
idstring
Required

Eindeutige ID des Kontakts, den Sie löschen möchten.

Antwortfelder

successboolean
Required

Kennzeichnet eine erfolgreiche Löschung.

Kontakte gesammelt importieren

Rufen Sie POST /api/crm/contacts/import auf, um viele Kontakte in einer Anfrage zu importieren. Der Endpunkt akzeptiert einen Body im Format contacts: [...] oder einen CSV-basierten Import, abhängig von Ihrem Import-Workflow.

Der Import-Endpunkt unterstützt laut Implementierung sowohl strukturierte JSON-Daten als auch CSV-Importe. Die Antwort enthält die Anzahl erfolgreich importierter Kontakte, fehlgeschlagener Einträge und gegebenenfalls eine Fehlerliste.

Request-Body

body
contactsarray

Liste von Kontakten für den JSON-Import.

Antwortfelder

successboolean
Required

Kennzeichnet einen erfolgreich verarbeiteten Importaufruf.

importedinteger
Required

Anzahl der erfolgreich importierten Kontakte.

failedinteger
Required

Anzahl der Kontakte, die nicht importiert werden konnten.

errorsarray
Required

Liste der Importfehler, sofern einzelne Einträge fehlschlagen.

Verwandte Inhalte

CRM-Unternehmen

CRM-Kampagnen

Was this page helpful?