Este documento traz as especificações técnicas para chamada da API “DigitalPostman” que faz disparos de arquivos via canal Whatsapp utilizando a plataforma Carteiro Digital.
AUTENTICAÇÃO #
Para efetuar chamadas em nosso portal de integrações o primeiro passo é a obtenção do Token de acesso. Para isto, deverá ser utilizada a seguinte requisição do tipo POST:
URL: https://api.robbu.global/v1/login
Body:
{
“Company”: “#####”,
“Username”: “#####”,
“Password”: “#####”
}
ESPECIFICAÇÕES DO BODY #
ESPECIFICAÇÕES DO BODY
{
“Company“: “Nome da empresa utilizado no login do ambiente“,
“Username“: ” NomeUsuarioAPI“,
“Password“: ” SenhaUsuarioAPI“
}
Informações utilizadas na tela inicial de login da Invenio
https://accounts.robbu.global/
Obs: O usuário deve ser do grupo de acesso Integração API
Obs: Não é obrigatório gerar um novo token a cada disparo de documento, pois o próprio
campo “expires_in” traz a quantidade em segundos de sua validade (porém por padrão
podem considerar como limite, a expiração do token em 3333 dias). Caso nossa API de
envio de boletos retorne “title”: “Unauthorized” é necessário renovar o TOKEN.
Uma vez criado um token, todos disparos de boletos pela rota /digitalpostman devem
utilizar o mesmo token, a renovação só é necessário caso API retorne não autorizado.
ENVIO BOLETOS #
Para efetuar o envio de boletos deverá ser utilizada a seguinte requisição do tipo POST:
URL: https://api.robbu.global/v2/digitalpostman
BODY #
{
"senderName": "",
"customData": "",
"contactName": "",
"contactId": "",
"walletCode": "",
"contactPhoneNumber": "",
"documentCollection": [
{
"documentCode": "",
"documentFileName": "",
"documentBase64": ""
}
]
}
ESPECIFICAÇÕES DO BODY #
SenderName: Nome do usuário remetente, pode ser o próprio CPF do usuário.(Obrigatório)
CustomData: Referência do usuário remetente, que será contabilizado como login emissor diretamente no Insights do Carteiro Digital. (Obrigatório)
ContactName: Nome do destinatário que receberá o arquivo. (Obrigatório)
ContactId: CPF/CNPJ do destinatário. Os 3 primeiros digitos do CPF/CNPJ são o token de confirmação para recebimento do arquivo.(Obrigatório)
Exemplo: 11122233344
O Token de confirmação é 111
WalletCode: Identificador da Carteira(Segmento), cadastrado pelo cliente dentro do Invenio. (Obrigatório)
ContactPhoneNumber: Telefone do destinatário. (Obrigatório)
DocumentCollection: Destinada a informações do documento a ser enviado.
DocumentCollection.DocumentCode: Linha digitavel(Cód.Barras) do boleto.
DocumentCollection.FileName: Nome que será apresentado no arquivo junto a sua extensão: (Obrigatório)
Exemplo: Arquivo.pdf
DocumentCollection.DocumentBase64: Base 64 do boleto a ser enviado. (Obrigatório)
RESPONSE DAS CHAMADAS #
A chamada possuirá os seguintes códigos de retorno:
200: A mensagem foi enviada corretamente
400: Parâmetros incorretos
500: Algum erro ocorrido no processo de envio.
EXEMPLO DE REQUISIÇÕES #
{
"senderName": "Robbu",
"contactName": "Robbu Teste",
"contactId": "11122233344",
"walletCode": "Carteira Teste",
"contactPhoneNumber": 5511988887777,
"documentCollection": [
{
"documentCode": "10203040",
"documentFileName": "arquivo.pdf",
"documentBase64":
"JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA+P
gpzdHJlYW0KeAF9jr0KwkAQhPs8xUSN3kVz2TuT3NkqNnaBhRTG6tBCiBDz/mD+Cm1kF3YWduebFiVaaDN07hxs4fC+o8
IL6anT8B1orM73d6RMNu2DOBAsOWUNfIMjBwkpItJgj3x6mgc3SJl7BviBK0S4kEg0xHIVrTezrkVUyzjc7iRuAV9w5jHZL1
HbTBV708f84v6DiVgG/JzMyg+1fjByCmVuZHN0cmVhbQplbmRvYmoK"
}
]
}Resultado
#
