Colocar o cliente de uma conversa numa carteira

Coloca o cliente da conversa (o lead; sem lead, o contato do canal, como o perfil @ do Instagram) na carteira de quem chama, ou na de holderId. A partir daí, toda conversa nova desse cliente vai direto para o dono da carteira, mesmo off-line, em vez de passar pela roleta; quando o canal tem IA ou fluxo, eles atendem primeiro e o repasse para humano vai para o dono da carteira. Conversas que já têm responsável não mudam. Colocar na própria carteira exige customer_portfolios:use e acesso à conversa; colocar na carteira de outro membro exige customer_portfolios:manage, o membro precisa estar entre as pessoas que quem chama pode ver (403 customer_portfolio_holder_out_of_reach) e poder ter carteira (409 customer_portfolio_holder_ineligible). Um cliente fica em no máximo uma carteira: se já está na de outro membro, 409 customer_portfolio_held_by_other com details.entryId, details.holderId e details.holderName (quem gerencia pode então mover com PUT /v1/customer-portfolio/entries/{entryId}). Repetir a carteira atual não muda nada.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required

Canal da conversa

Allowed:
string
required

ID da conversa (UUID)

Body Params

Dono da carteira (vazio para a própria)

string
Headers
string

Departamento que limita os dados. Quem não participa do departamento recebe 403; donos e administradores escolhem qualquer um.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json