Perfis de clientes e tickets
Consulte e sincronize perfis de clientes e crie tickets a partir do seu sistema.
4.4 Ficha do cliente
As conversas de um mesmo cliente são agrupadas em uma única ficha de cliente, e o contact_id da conversa aponta para ela. Regras de identificação: o ID de membro que você assina (user_token ou o user.id enviado pela API) > usuário do canal (como o openid do WeChat) > visitante do site. Visitantes anônimos são incorporados à ficha do membro após o login; dois membros diferentes não são mesclados automaticamente, e e-mails ou telefones iguais apenas geram um aviso no painel, para que o atendente faça a mesclagem manual.
| Método | Caminho | Descrição |
|---|---|---|
| GET | /v1/contacts?user_id= ou ?email= | Consulta a ficha do cliente pelo seu ID de membro ou e-mail |
| GET | /v1/contacts/{id} | Ficha do cliente: nome, e-mail, telefone, tags tags, observações notes, campos personalizados attributes, número de conversas, horário da última visita, IDs de membro user_ids |
| PATCH | /v1/contacts/{id} | Sincroniza dados do seu sistema: name, phone, tags (no máximo 30), notes, attributes (substituição total, no máximo 30 campos). Envie apenas os campos que deseja alterar |
4.5 Tickets
| Método | Caminho | Descrição |
|---|---|---|
| POST | /v1/tickets | Cria um ticket, por exemplo a partir do formulário "Fale conosco" do site: subject, description, priority (urgent / high / normal / low), name / email / phone do cliente e, opcionalmente, conversation_id ou contact_id para vincular. Se houver e-mail, as respostas do atendente serão enviadas ao cliente por e-mail |
| GET | /v1/tickets/{id} | Ticket e linha do tempo (mensagens do cliente, respostas do atendente, mudanças de status; não inclui observações internas) |
Status do ticket: open aguardando atendimento, pending aguardando o cliente, resolved resolvido, closed encerrado. O prazo de atendimento por prioridade é definido em "Configurações do robô".
Esta página foi útil?
Última atualização:
