Metadados Base64
Aqui você irá encontrar um modelo dos parâmetros do customer, que deverão ser encaminhados à D1 para o envio das comunicações com arquivo, em Base64
Customer é um objeto que representa o cliente dentro da plataforma.
Body de exemplo
Atributos
CAMPO | DESCRIÇÃO |
id | Deve ser a chave única para identificação do customer e que será utilizada para updates futuros. Normalmente utilizado com dados de CPF ou CNPJ. Caso um mesmo customer seja informado com outro valor neste campo, o customer será DUPLICADO. Obrigatório |
name | (nome) Obrigatório |
nickname | (apelido) nome curto e fácil de recordar, pelo qual uma pessoa se identifica |
personType | (Tipo pessoa). Dados suportados: natural/legal |
gender | (Sexo) Dados suportados: male/female |
maritalStatus | (Estado Civil) Dados suportados: married/divorced/widowed/single/clmarried/other |
birthDate | (Data Aniversário) formato suportado: yyyy-MM-ddThh:mm:ss.dddZ |
emails | Lista dos e-mails do customer ➢ address: deve estar como lower case. Obrigatório ➢ kind: deve seguir o modelo tipo de contato. Obrigatório |
emails.kind | Identifica o tipo do e-mail. Os valores válidos são: ➢ residential ➢ comercial ➢ other |
emails.address | É o endereço de e-mail do destinatário da comunicação. |
phones | Lista dos telefones do customer ➢ number: deve estar no formato 551199999999. Obrigatório ➢ Kind: deve seguir o modelo tipo de contato. Obrigatório |
phones.kind | Identifica o tipo do telefone. Os valores válidos são: ➢ residential ➢ comercial ➢ cellphone ➢ other |
phones.address | É o número do telefone do destinatário. Para envio de comunicação esse número deve ser um celular. |
addresses | Lista dos endereços do customer ➢ street, number, complement, neighborhood, city, devem estar previamente formatados corretamente. ➢ state: deve possuir o valor da UF. ➢ zipCode: deve estar no formato: 0000-000. ➢ country.id: deve estar de acordo com a ISO 3166-1. Deve-se utilizar números inteiros (sem zero à esquerda). Obrigatório ➢ country.name: nome do país. ➢ kind: deve seguir o modelo tipo de contato. Obrigatório ➢ geocode: deve ser latitude e longitude. |
addresses.street | Descrição do endereço (rua, Av, etc) |
addresses.number | Número do endereço |
addresses.complement | Complemento do endereço |
addresses.neighborhood | Bairro |
addresses.state | Sigla do estado |
addresses.zipCode | Número do CEP |
addresses.country.id | Identificação do país de acordo com a ISO 3166-1. Deve-se utilizar números inteiros (sem zero à esquerda) |
addresses.country.name | Nome do país |
addresses.kind | Identifica o tipo do endereço. Os valores válidos são: ➢ residential ➢ comercial ➢ other |
addresses.geocode | Informação de geolocalização do cliente |
documents | Lista dos documentos do customer, formato suportado: {“chave”: “valor”} |
Campo files
O objetivo desse campo é informar para a plataforma como serão enviados os arquivos de uma determinada comunicação. Esse campo une informações dos campos Kit, Documents e Attachments
Atributos
CAMPO | DESCRIÇÃO |
type | Indica a localização do arquivo, ou seja, onde ele está armazenado. Seu objetivo é permitir que a plataforma consiga enviar arquivos armazenados em qualquer fonte externa, como por exemplo um storage do cliente. Nesta versão apenas os valores Storage e Base64 são suportados. O valor Storage indica para a plataforma que o arquivo está armazenado em nosso Storage Service que é um serviço de gerenciamento de arquivos. O valor Base64 indica que será utilizado o arquivo enviado em formato Base64 na requisição. |
mode | Indica a forma como o arquivo será disponibilizado dentro da comunicação.
Attachment: o arquivo será anexado a comunicação caso o canal permita (e-mail, WhatsApp, RCS, etc)
Link: O arquivo será enviado no corpo da comunicação como um URL.
Info: Utilizando apenas para o serviço Customer. |
isMain | Indica que o arquivo é o arquivo principal dentro do conjunto de arquivos enviados, caso exista mais de um. Essa informação é importante para que a plataforma consiga identificar qual dos arquivos deverá ser enviado como link quando utilizamos a variável ${link_documento} |
storagePath | É o caminho onde o documento está armazenado no storage. Esse campo deve ser informado apenas para quando o tipo for ‘Storage’ (type = ‘Storage’) |
filename | É o nome do arquivo. Esse nome será exibido no e-mail quando for um anexo ou será o nome que os navegadores utilizarão para salvá-lo em disco em caso de download. |
description | É uma descrição para o arquivo. Será utilizada para a feature de loop de documentos. |
correlationId | É uma chave de identificação única do arquivo e é utilizada para a realização do download |
nodes | Esse campo é opcional Deve ser utilizado quando houver necessidade de especificar para qual nó de canal o arquivo deve ser tratado e enviado.
Por exemplo: é possível parametrizar que um arquivo deve ser enviado para o canal de e-mail e outro para o canal de WhatsApp. Caso não seja informado, todos os arquivos serão anexados em todos os canais. |
nodes.name | Indica em qual nó de canal o arquivo será disponibilizado. Exemplo: E-mail 2 (deve ser idêntico ao nome dado à comunicação dentro da jornada).
Attachment: O arquivo será anexado a comunicação caso o canal permita (e-mail, whatsapp, rcs, etc) Link: O arquivo será enviado no corpo da comunicação como um URL. |
Campos tipo Base64File
CAMPO | DESCRIÇÃO |
content | Arquivo em formato Base64. Obrigatório quando Type igual a base64. |
contentType | ContentType do arquivo. Obrigatório quando Type igual a base64. |
Campos tipo Date
É importante que todos os campos do tipo date sejam enviados utilizando o formato ISO-86001.
O controle do fuso horário assim como o horário de verão é de responsabilidade de quem está chamando a API.
Exemplo: 1980-07-15T03:00:00.000Z
Last updated