Ringostat API. Wysyłanie informacji do Ringostat Smart Phone i książki kontaktów

Wysyłanie informacji do Ringostat Smart Phone i książki kontaktów

Ta metoda umożliwia przesyłanie informacji o kontakcie/leadzie/transakcji do Ringostat Smart Phone oraz książki kontaktów. Pozwala na przekazywanie danych z systemów CRM integrowanych za pośrednictwem Webhook, w celu wyświetlania informacji o kliencie w książce kontaktów Ringostat Smart Phone oraz rejestrze połączeń.

Za pomocą tej metody można przesyłać:

Imię i nazwisko
Numer telefonu
Adres e-mail
Szybki link do kontaktu lub transakcji

Podstawowe parametry żądania:

Adres żądania API: https://api.ringostat.net/minicrm/contacts/sync

Metoda — POST

Nagłówki żądania:

Content-Type - application/json
auth-key — klucz elektroniczny umożliwiający dostęp do projektu w Ringostat
x-project-id — identyfikator projektu

Treść żądania:

Nazwa parametru	Typ danych	Wymagany	Opis
projectId	int	Tak	Identyfikator projektu (określony w bloku dostępu)
fullName	string	Tak	Imię i nazwisko kontaktu
origin	string	Tak	Nazwa CRM
externalId	string	Tak. Może = null, jeśli pole lead_id jest wypełnione	ID kontaktu w CRM
leadId	string	Tak. Może = null, jeśli pole external_id jest wypełnione	ID leada w CRM
responsible	string	Tak	ID odpowiedzialnego pracownika w CRM. Wartość może być w formacie numerycznym lub tekstowym. Jeśli nie ma odpowiedzialnego — można przesłać „0" lub „Unknown"
staffId	string	Tak. Może = null	ID pracownika w Ringostat zgodnie z ustawieniami integracji
contactLink	string	Tak. Może = null	Link do kontaktu
leadLink	string	Tak. Może = null	Link do leada
dealLink	string	Tak. Może = null	Link do transakcji
googleClientId	string	Tak. Może = null	Identyfikator klienta z Google Analytics
contactDirections	array of objects	Tak	Tablica z numerami telefonów i adresami e-mail kontaktu — musi zawierać co najmniej jeden kierunek
type	string	Tak	Typ kierunku: phone/email
name	string	Tak	Nazwa kierunku (work, personal itp.)
value	string	Tak	Numer telefonu lub adres e-mail
organizations	array of objects	Tak. Może = null	Tablica organizacji, do których należy kontak
projectId	int	Tak, jeśli „organizations" jest wypełnione	Identyfikator projektu (określony w bloku dostępu)
name	string	Tak, jeśli „organizations" jest wypełnione	Nazwa organizacji
externalid	string	Tak, jeśli „organizations" jest wypełnione	ID organizacji w CRM
origin	string	Tak, jeśli „organizations" jest wypełnione	Nazwa CRM

Przykład żądania:

curl -i -X POST \
-H "auth-key:unique_auth_key_value" \
-H "x-project-id:project-id" \
-H "Content-Type:application/json" \
-d \
'{
"contacts": [
{
"projectId": project-id,
"fullName": "Client name",
"origin": "Crm name",
"externalId": null,
"leadId": "7895643",
"responsible": "manager1",
"staffId": null,
"contactLink": "https://crmname.com/contact/6835653",
"leadLink": "https://crmname.com/lead/7895643",
"dealLink": "https://crmname.com/deal/1835367",
"googleClientId": null,
"organizations": [
{
"projectId": project-id,
"name": "Organization name",
"externalId":"124532",
"origin": "Crms name"
}
],
"contactDirections": [
{
"name": "Client name",
"type": "phone",
"value": "+380111111111"
},
{
"name": "Client name",
"type": "email",
"value": "с[email protected]"
}
]
}
]
}' \
'https://api.ringostat.net/minicrm/contacts/sync'

Przesyłanie informacji o organizacji do Ringostat Smart Phone

Ta metoda przesyła informacje o organizacji w celu uzupełnienia danych kontaktu w książce kontaktów Ringostat Smart Phone.

Podstawowe parametry żądania:

Adres żądania API: https://api.ringostat.net/minicrm/organizations/sync
Metoda — POST

Nagłówki żądania:

Content-Type - application/json
auth-key — klucz elektroniczny umożliwiający dostęp do projektu w Ringostat
x-project-id — identyfikator projektu

Treść żądania:

curl -i -X POST \
-H "auth-key:unique_auth_key_value" \
-H "x-project-id:project-id" \
-H "Content-Type:application/json" \
-d \
'{
"organizations": [
{
"projectId": 106,
"name": "organization1",
"externalId": "1",
"origin": "Crm"
},
{
"projectId": 106,
"name": "organization2",
"externalId": "2",
"origin": "Crm"
},
{
"projectId": 106,
"name": "organization3",
"externalId": "3",
"origin": "Crm"
}
]
}' \
'https://api.ringostat.net/minicrm/organizations/sync'

Opis i przykłady można również znaleźć w panelu klienta, w sekcji „Ustawienia" — „Integracje" — „Ringostat API", klikając wybraną metodę API: