Erstelle eine API Schnittstelle

In diesem Tutorial zeigen wir Dir, wie Du eine Anforderungsquelle mit einer benutzerdefinierten API erstellen kannst.

☝ API (Application Programming Interface) ist eine Vermittlungssoftware, die die Kommunikation und den Austausch von Informationen zwischen zwei Programmen ermöglicht.

Erstellen einer neuen API-Quelle

Gehe vom Home Dashboard aus zu Einstellungen ( Settings.)

Klicke auf Posteingangscenter- Einstellungen ( Inbox center settings .)

Klicke auf New source.

Wählen Sie die Art der Eingangsquelle, die Sie erstellen möchten:

Gemeinsame Firmen-E-Mail: Verwende diese E-Mail für deine Firmen-E-Mails, die von deinem Team eingesehen werden kann.
Einfaches Formular: Erstelle dein Formular und bette es in deine Website ein
Benutzerdefinierte API-Quelle: Erstelle ein Formular, das von deiner Website über die API mit Samdock verbunden wird.

Für diesen Vorgang wählen wir die benutzerdefinierte API-Quelle. (Custom API Source)

Richte die URL für die Anfrage ein

Kopiere die URL unten mit der ID für deine API-Schnittstelle. Diese URL wird von deinen Anbieter (normalerweise Ihr Formularanbieter) verwendet, um Informationen über die API an Samdock zu übermitteln.

https://samdock.app/api/contacts/drafts/{source-ID}

{
  "person": {
	"email": "String@email.com",
	"firstName": "String", 
	"lastName": "String",
	"gender": "female",
	"namePrefix": "Prefix",
	"nameSuffix": "Suffix",
	"mobileNumber": "String", 
	"phoneNumber": "String", 
	"officeNumber": "String", 
	"homeNumber": "String",
	"privateNumber": "String",
	"faxNumber": "String", 
	"website": "www.string.com", 
	"linkedin": "String", 
	"xing": "String", 
	"twitter": "String", 
	"facebook": "String", 
	"instagram": "String", 
	"birthday": "yyyy-mm-dd", 
	"address": { 
		"street": "String", 
		"number": "String", 
		"postcode": "String", 
		"city": "String" 
		},
	"customFields": {
            "person-text": "String",
            "person-singleSelect": [
                "optionID"
            ],
            "person-multiSelect": [
                "optionID",
                "optionID"
            ],
            "person-currency": Number
                }
	},
  "organization": { 
	"website": "www.string.com", 
	"name": "String", 
	"email": "String@email.com", 
	"isCustomer": true, 
	"phoneNumber": "String", 
	"faxNumber": "String", 3
	"linkedin": "String", 
	"xing": "String", 
	"twitter": "String", 
	"facebook": "String", 
	"instagram": "String", 
	"vatRegNo": "String", 
	"address": { 
		"street": "String", 
		"number": "String", 
		"postcode": "String", 
		"city": "String" 
		},
	"customFields": {
            "organization-text": "String",
            "organization-singleSelect": [
                "optionID"
            ],
            "organization-multiSelect": [
                "optionID",
                "optionID"
            ],
            "organization-currency": Number
	},
  "lead": { 
	"name": "String", 
	"customerRequirement": "String"
	}
}

Bereite den Text für die Anfragen vor

Bei der Buchung in eine Quelle sollte der Text der Anfrage mit den Feldern übereinstimmen, die in den Einstellungen der Quelle festgelegt sind.

Nachfolgend findest du die Feldschlüssel-Namen und die Werttypen, die von der API erwartet werden.

Hinweis: person.lastName, organization.name und lead.name sind MUSS-Felder

Umsetzung

Dieser Schritt hängt davon ab, was du versuchst, mit Samdock zu verbinden.
Prüfe die Dokumentation deines Anbieters, um zu erfahren, wie du sie implementieren kannst.
⚠️ Sollten Probleme auftreten, wende dich bitte an unser Support-Team, damit es Sie dich beraten können.