Resolve or create a widget conversation
POST/conversations
Resolves an eligible widget conversation or atomically creates an empty one. Reused conversations keep their existing status. Use exactly one of contact or contact_id. This operation sends no message; the employee composes the first message in Evercom.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 500
Eligible widget conversation resolved without changing its status
Response Headers
RFC 3339 time until which the same idempotency key reproduces this result; at least 24 hours after the first request
Empty widget conversation created; no message is sent
Response Headers
RFC 3339 time until which the same idempotency key reproduces this result; at least 24 hours after the first request
contact.external_id_required, contact.invalid_email, contact.invalid_external_id, contact.invalid_locale, contact.invalid_name, public.idempotency_key_required, public.idempotency_key_invalid, public.invalid_request
unauthorized
forbidden, contact_blocked
not_found
public.idempotency_key_reused, public.request_in_progress
Response Headers
Seconds to wait before retrying when the original request is still in progress
rate_limited
internal_error