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.12

Parametri 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.12

Parametri 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=&uniqueid

Parametri 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