Tätigen Sie einen Anruf von einer der Telefonnummern Ihres Workspace. Jeder Request braucht einen eindeutigen Idempotency-Key; wird derselbe Schlüssel erneut gesendet, kommt derselbe Anruf zurück, statt doppelt zu wählen.
curl https://evasay.com/api/v1/voice/calls \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "AGENT_ID",
"to": "+14155550100",
"variables": { "customer_name": "Alex", "order_id": "1234" }
}'
from ist erforderlich, wenn der Workspace mehr als eine Telefonnummer hat. variables füllen Platzhalter wie {{customer_name}} in der ersten Nachricht und im Prompt des Agents.
Mit aktivem voicemail_detection (Standard) hört ein ausgehender Anruf, ob die Gegenseite spricht, bevor der Agent grüßt; bleibt sie still, grüßt der Agent nach zwei oder drei Sekunden. Hört der Agent eine Mailbox oder eine Ansage der Telefongesellschaft, wartet er, bis Ansage und Piepton vorbei sind, hinterlässt voicemail_message oder legt auf, wenn es keine gibt. Solche Anrufe enden mit ended_reason voicemail, werden für ihre Dauer berechnet und weder analysiert noch gemeldet.
In einer Kampagne wird eine Nummer, die eine Mailbox erreicht hat, erneut angerufen wie eine, die nicht abgenommen hat, und die Nachricht wird nur beim letzten Versuch hinterlassen, sodass niemand dieselbe Nachricht zweimal bekommt.
Jeder ausgehende Anruf, aus einer Kampagne oder über POST /api/v1/voice/calls, prüft zuerst die Sperrliste des Workspace. Eine gelistete Nummer wird nie gewählt: Die API antwortet 409 mit code do_not_call, und eine Kampagne markiert den Kontakt als canceled mit outcome do_not_call und macht mit dem nächsten weiter.
Bittet die Person bei einem vom Agent getätigten Anruf darum, nicht mehr angerufen zu werden, setzt der Agent ihre Nummer selbst auf die Liste, sagt es ihr, und der Webhook call.do_not_call wird gesendet. Nummern können auch unter Kampagnen → Sperrliste oder per API hinzugefügt und entfernt werden:
curl https://evasay.com/api/v1/voice/do-not-call \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "phones": ["+14155550100"], "note": "Asked by email" }'
Nummern stehen im internationalen Format; bis zu 1.000 auf einmal. GET /api/v1/voice/do-not-call listet sie, neueste zuerst (search, limit, page), jeweils mit ihrer source (call, dashboard oder api). DELETE /api/v1/voice/do-not-call/%2B14155550100 nimmt eine wieder herunter; tun Sie das nur, wenn die Person zugestimmt hat, angerufen zu werden.