Criação / atualização de contatos

Objetivo

Permite que o cliente crie ou altere dados de um contato no Mosia Omnichannel

Endpoint

Endpoint	Método	Header Content-Type	Ambiente	Descrição

Endpoint	Método	Header Content-Type	Ambiente	Descrição
https://api.mosiaomnichannel.com.br/clientes/contatos/contato	POST	application/json	Sandbox e produção	Cria ou atualizar um contato

Headers

Parâmetro	Obrigatório	Tipo	Descrição

Parâmetro	Obrigatório	Tipo	Descrição
Authorization	M	token do cliente	Token de autenticação de cliente

Parametros de entrada

Serão enviados no BODY os seguintes parâmetros:

Parâmetro	Obrigatório	Tipo	Descrição

Parâmetro	Obrigatório	Tipo	Descrição
contato	M	Objeto	Informações do contato

Objeto Contato [M]

Parâmetro	Obrigatório	Tipo	Descrição

Parâmetro	Obrigatório	Tipo	Descrição
nome	M	String	Nome do beneficiário, prestador ou outros.
email	OP	String	Email
telefone	OP	String	Telefone
chaveUnica	M	String	Chave Única

{
    "nome": "João da Silva",
    "email": "joao.silva@mobilesaude.com.br",
    "telefone": "27997981966"
    "chaveUnica": "92823599053",
}

Request body

{
    "contato": {
        "nome": "João da Silva",
        "email": "joao.silva@mobilesaude.com.br",
        "telefone": "27997981966",
        "chaveUnica": "92823599053"
    }
}

Objetos e atributos de retorno

Descrição dos objetos e atributos de retorno - Sucesso

Está indicado abaixo a estrutura de retorno do método de criação ou atualização de contato.

{
  "status": true,
  "data": {
       "idOmniContato": "xyz ",
       "idOperadora": 489,
       "idConfigClienteApp": 372,
       "chaveUnica": "92823599053",
       "nome": "João da Silva",
       "email": "joao.silva@mobilesaude.com.br",
       "telefone": "27997981966",
       "instancia_aplicacao": 1,
       "bundle": "br.com.mobilesaude.operadorars",
       "perfilContato": {}
  },
  "message": "Contato salvo com sucesso.",
  "critical": [],
  "statusCode": 200,
  "timestamp": 1726671480104
}

Exemplo prático de uso

Estamos utilizando a api para atualização de contato no fluxo de identificação na funcionalidade de chatbot.

1º Fluxo de entrada do chatbot de operadora exemplo

No fluxo de entrada foram criados dois nós do tipo input (Email e Telefone) após o objeto identificação que solicita a chave única e o nome caso não seja possível identificar então cria o contato, caso contrário, identifica e solicita o email e telefone atualizando o contato existente.

imagem 1: Fluxo de entrada

2º Nós do tipo input do email e telefone

Os dados informados nos dois inputs vão ser armazenados nas variaveis definidas abaixo e repassados para o nós de API onde a nossa requisição irá atualizar o contato.

imagem 2: Nó input (Telefone)

3º Nós de API (Contato)

Neste componente nos repassamos no body da requisição da api de contatos, todas as informações recuperadas dos nós de identificação e input.

4º Testando o chatbot

Fluxo de criação / atualzação do contato pelo chat bot.

5º Contato sendo visualizado no painel do atendente