Trimitere Events (WebHook)¶
Webservice-ul va fi apelat de While1 Voice in momentul cand un agent raspunde la un apel, pe un URL care va fi setat in Editare proiect, campul sendEvent. Raspunsul webservice-ului va trebui sa fie un continut gol cu header 200.
Se trimit events pentru urmatoarele tipuri de actiuni:- Answer Events (queue_answer, queue_answer_end, dial_answer, call_forward_answer)
- Missed Calls (missed_calls)
- Apeluri Outgoing (outgoing_end)
1. Answer Events¶
Exemplu URL:
http://example.com/api/while1voice_ev?event=queue_answer&direction=IN&project_id=1&agent=test-user&remote_number=&telephone=0700000000&dnid=0300000000&dnid_identifier=&contact_id=&queue=callcenter-queue&uniqueid=1234567890.12Parametri trimisi (metoda GET):
- event => poate fi: queue_answer, queue_answer_end, dial_answer sau call_forward_answer
- direction => IN
- project_id => identificatorul extern al proiectului
- agent => user-ul care a raspuns
- remote number => numarul de mobil extern care a raspuns apelului (fallback_number sau remote_agent)
- telephone => numarul apelantului
- dnid => numarul la care s-a sunat
- dnid_identifier => PBX :: Inbound routes :: Edit route - External identifier
- contact_id => ID-ul furnizat din Webservice-ul de recunoastere apelant
- queue => numele cozii apelate
- uniqueid => ID-ul unic de apel
2. Missed calls¶
Exemplu URL:
http://example.com/api/while1voice_ev?event=missed_calls&project_id=123&queue=test-queue&queue_hold_time=1&telephone=0700000000&dnid=0210000000&dnid_identifier=&contact_id=123456&fail_reason=queue_hangup&explain_reason=&uniqueid=1234567890.12Parametri trimisi (metoda GET):
- event => poate fi: missed_calls
- project_id => identificatorul extern al proiectului
- queue => numele cozii
- queue_hold_time => timpul de asteptare in coada, in secunde
- telephone => numarul apelantului
- dnid => numarul la care s-a sunat
- dnid_identifier => PBX :: Inbound routes :: Edit route - External identifier
- contact_id => ID-ul furnizat din Webservice-ul de recunoastere apelant
- fail_reason => motivul pentru apelul ratat (ex: queue_hangup, forward_hangup, no_schedule, queue_busy)
- explain_reason => explicatia pentru fail_reason (statusul cozii sau al apelului)
- uniqueid => ID-ul unic de apel
3. Outgoing calls¶
Exemplu URL:
http://example.com/api/while1voice_ev?event=outgoing_end&direction=OUT&project_id=123&agent=test-user&telephone=0700000000&dnid=0210000000&dnid_identifier=&contact_id=123456&dialstatus=BUSY&duration=&uniqueidParametri trimisi (metoda GET):
- event => poate fi: outgoing_end
- direction => OUT
- project_id => identificatorul extern al proiectului
- agent => userul care a apelat
- telephone => numarul apelatului
- dnid => numarul de la care s-a sunat
- dnid_identifier => PBX :: Inbound routes :: Edit route - External identifier
- contact_id => ID-ul furnizat din Webservice-ul de recunoastere a apelatului
- dialstatus => statusul apelului
- duration => durata apelului
- uniqueid => ID-ul unic de apel
Disponibil si in alte limbi: EN
Go to top