Pular para o conteúdo principal

​
API Update Contact – Criação e Atualização de Contatos

A API Update Contact permite que você crie ou atualize registros de contatos dentro do ambiente Invenio de forma simples e automatizada. Esse recurso é essencial para manter a base de dados sempre atualizada, garantindo que o atendimento e os fluxos automáticos da plataforma funcionem com mais eficiência e precisão.

​
Autenticação

Para utilizar esta API, é necessário realizar uma autenticação prévia via API de Login.

​
Endpoint de Login

POST https://api.robbu.global/v1/login

​
Exemplo de corpo da requisição:

{
  "Company": "NOME_DA_EMPRESA",
  "Username": "USUARIO_API",
  "Password": "SENHAUSUARIO_API"
}
CampoDescrição
CompanyNome do ambiente utilizado no login da plataforma
UsernameNome do usuário com permissão do grupo de acesso “Integração API”
PasswordSenha do usuário de integração
O token de autenticação tem um tempo de expiração (campo expires_in), podendo durar até 3333 dias. Caso a API retorne "title": "Unauthorized", será necessário renovar o token.

​
Requisição para Atualização de Contato

​
Endpoint

POST https://robbuapi.azurewebsites.net/v1/updatecontact

​
Corpo da requisição

{
  "invenioPrivateToken": "SEU_TOKEN_PRIVADO",
  "name": "João da Silva",
  "customCode": "cliente_001",
  "id": "12345678900",
  "tag": "prioridade_alta",
  "jokers": ["R$50,00", "Contrato123", "Xpto", "coringa4", "coringa5"],
  "walletClientCode": "CART001"
}

​
Especificação dos Parâmetros

CampoTipoObrigatórioDescrição
invenioPrivateTokenStringSimToken privado obtido em Invenio Center > Configurações de conta
nameStringSimNome completo do contato
customCodeStringNãoCódigo personalizado para o contato
idStringSimCPF ou CNPJ do contato
tagStringNãoTag associada para segmentação/classificação
jokersArrayNãoLista de até 5 variáveis coringa usadas dinamicamente em templates
walletClientCodeStringNãoCódigo da carteira/segmento vinculado ao contato

​
Respostas da API

CódigoDescrição
200Contato atualizado ou inserido com sucesso
400Erro de validação nos parâmetros da requisição
401Token inválido ou expirado
500Erro interno do servidor

​
⁉️ Perguntas Frequentes (FAQ)

Não. O token tem tempo de expiração configurado (até 3333 dias). Gere um novo somente se expirar.
Não. O campo id é obrigatório e deve conter o CPF ou CNPJ do contato.
Até 5 valores no array, que podem ser utilizados dinamicamente em templates personalizados.
Verifique o código de resposta HTTP. Um retorno 200 indica sucesso.