Para facilitar integrações usando o bot, é conveniente criar um campo personalizado do tipo JSON que vai receber dados da sua integração que você pode depois usar para realizar decisões no bot ou emitir mensagens.
Para fins de exemplo, vamos supor que você queira fazer uma integração para consultar o status do pedido, a previsão de entrega e passar essa informação para o usuário. Então vamos realizar um passo a passo de como você faria isso no BOT usando o campo personalizado do tipo JSON.
Primeiro passo é ir em Configurações > Campos personalizados e criar um campo do tipo JSON.
Note que esse campo personalizado foi criado com a chave de placeholder “status” que iremos usar para referenciar esse campo posteriormente.
Após isso crie um bot que irá realizar a integração do nosso exemplo e coloque uma ação de integração personalizada. Conforme a imagem
Essa integração irá realizar uma chamada [POST] na rota de exemplo “url”. Irá passar como body o email do contato e espera como resultado um objeto dentro da chave "data”, que irá ser salva no campo customizado que tem o placeholder “status”, que criamos anteriormente.
Após isso podemos acessar as propriedades dentro do JSON para enviar mensagens ou realizar decisões. Primeiro vamos mostrar o número do pedido dele em uma mensagem. Para fazer isso devemos usar o padrão do lodash de caminho de um objeto. Você pode saber mais sobre isso no estudando a documentação nesse link.
No exemplo acima o bot irá pegar o valor que estiver no campo personalizado “status” e substituir na mensagem pelo valor da chave “pedido” que vem dentro de status. Ou seja, subentende-se que no exemplo, ao realizar a integração o body de resposta retornou algo como o seguinte JSON:
{
data: {
pedido: "123456",
dias_para_entrega: 5
}
}
A seguir vamos realizar uma decisão caso a entrega seja para hoje:
Caso os dias para entrega seja maior que 5, diremos que faltam x dias, caso seja para hoje, dizemos que a entrega será realizada hoje.
