Abre, ou reaproveita, a conversa do número phoneNumber neste número conectado e a atribui a quem a iniciou, para que o agente ou fluxo do número não responda ao contato enquanto essa pessoa for a responsável. Uma conversa de um colega continua com o colega, e uma delegação feita por uma pessoa continua valendo. Se a conversa não puder ser atribuída a quem a iniciou, nada é aberto e a resposta é 503 starter_not_assigned (tente de novo). Envie handOff ({kind: agent ou workflow, id, values}) para que a conversa já comece com um agente de IA ou um fluxo: exige a permissão conversations:delegate, o agente precisa estar ativo e o fluxo publicado e ativo, e values traz as variáveis que a automação exige (veja GET /automation-needs). A passagem é conferida antes de a conversa ser aberta: 403 hand_off_forbidden, 400 automation_invalid, 422 automation_unusable, 409 automation_variables_missing (details.variables com as que faltam), 422 conversation_variable_type_invalid e 400 conversation_variable_not_needed. A conversa começa com quem a iniciou e passa ao escolhido logo depois; handOff na resposta diz se passou (delegated, owner ai:code). Um fluxo começa na hora; um agente responde a partir da primeira mensagem do contato.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||