Ta metoda umożliwia wypełnianie kampanii Power Dialer za pośrednictwem API.
Podstawowe parametry żądania:
Adres żądania API: https://api.ringostat.net/power-dialer/campaigns/campaign-rows
Metoda: POST
Auth-key: klucz elektroniczny umożliwiający dostęp do projektu w Ringostat
projectId: identyfikator projektu
Aby wypełnić kampanię w Power Dialer, należy ją najpierw utworzyć:
1. W tym celu przejdź do: Ustawienia > Ustawienia Ringostat Smart Phone > Power Dialer:
2. W ustawieniach „Power Dialer" kliknij „+Dodaj kampanię", wprowadź nazwę kampanii i zapisz
3. Następnie kliknij trzy pionowe kropki po prawej stronie nazwy, aby otworzyć menu kontekstowe, w którym wybierz „Edytuj listę numerów kampanii"
Zostaniesz przekierowany na stronę, gdzie zostaniesz poproszony o przesłanie listy numerów kampanii — nie jest to jednak konieczne. Skopiuj adres URL strony, który będzie wyglądał mniej więcej tak: https://power-dialer.ringostat.com/campaign/edit?projectId=123&editCampaign=456&campaignName=ddd
Do kolejnej metody będą potrzebne następujące wartości parametrów:
projectId — wartość należy przekazać w nagłówkach w polu x-project-id
editCampaign — wartość należy przekazać w treści żądania w polu „campaignId"
4. Klucz autoryzacyjny wymagany do wypełnienia kampanii za pośrednictwem API można znaleźć na stronie „Ustawienia" > „Integracje" > „Ringostat API". Na tej stronie należy skopiować wartość Auth-key i przekazać ją w nagłówkach w polu Auth-key.
5. Aby wypełnić kampanię numerami za pośrednictwem API, potrzebne są następujące parametry:
URL | |
Nagłówki | x-project-id: 123 Auth-key: xxx Content-Type: application/json |
Metoda | POST |
Treść żądania |
|
Wartość campaignId pobieramy z adresu URL strony. Przykład: https://power-dialer.ringostat.com/campaign/edit?projectId=123&editCampaign=456&campaignName=ddd — w tym przypadku jest to 456
Parametr fio jest opcjonalny i nie musi być przekazywany.
Parametr phone_number jest wymagany, a numer musi być w formacie międzynarodowym: +48YYYXXXXXXX
Przykład dla Node.js:
const https = require('https');
const data = JSON.stringify({
campaignId: 456,
fio: "Ivan Petrenko",
Phone number: "380930000000"
});
const config = {
host: 'api.ringostat.net',
путь: '/power-dialer/campaigns/campaign-rows',
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Content-Length': Buffer.byteLength(data),
'x-project-id': '123',
'Authorization Key': 'your_unique_authorization_key'
}
};
const callback = (response) => {
let result = Buffer.alloc(0);
response.on('data', chunk => {
result = Buffer.concat([result, chunk]);
});
response.on('end', () => {
console.log(result.toString());
});
};
const request = https.request(config, callback);
request.write(data);
request.end();
Przykład dla Axios.js:
const axios = require('axios');
axios({
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-project-id': '123',
'Authorization Key': 'xxx'
},
data: {
campaignId: 456,
fio: "Ivan Petrenko",
Phone number: "380930000000"
}
})
.then(response => {
console.log(response.data);
})
.catch(error => {
console.error(error.response?.data || error.message);
});
Przykład dla cURL:
curl -X POST "https://api.ringostat.net/power-dialer/campaigns/campaign-rows" \
-H "Content-Type: application/json" \
-H "x-project-id: 123" \
-H "Authorization Key: xxx" \
-d '{
"campaignId": 456,
"fio": "Ivan Petrenko",
"phone_number": "380930000000"
}'
Wynik:
{
"result": true
}
Ograniczenia:
Maksymalnie 1 numer na żądanie
Wartości parametrów fio i phone_number należy pobierać z systemu CRM.