Bloco de integração
Consultar ou enviar dados a outro sistema no meio da conversa com o cliente.
O bloco de integração permite que o fluxo de bot converse com sistemas externos durante o atendimento. É o que torna possível, por exemplo, o cliente digitar o CPF e o bot responder com a segunda via do boleto.
O que dá para fazer
- Criar leads num sistema de CRM
- Cadastrar clientes em sistemas externos
- Consultar segunda via de boletos
- Buscar status de pedido, contrato ou chamado
Você monta, administra e altera essas integrações direto no fluxo, sem depender da SM Click para cada mudança.
Requisitos
Ao menos uma instância ativa. É por meio dela que o fluxo atende. A instância está disponível no plano Gamma, ou pode ser adquirida separadamente no gerenciamento da assinatura.
O sistema de destino precisa ter API REST. Sem isso, não há como o bot conversar com ele.
Alguém que entenda de API. Este bloco é a parte mais técnica da plataforma.
Diferente do resto do fluxo, aqui você precisa saber o que é método HTTP, cabeçalho, corpo em JSON e autenticação por token.
Se isso não faz parte do seu dia, vale envolver quem cuida de sistemas na sua empresa — ou verificar se uma integração nativa já resolve.
O que você precisa saber sobre APIs
Os conceitos mínimos:
API — o conjunto de regras que permite dois sistemas se comunicarem.
HTTP e HTTPS — os protocolos usados nessa comunicação.
Métodos HTTP — GET obtém informação, POST envia, PUT atualiza, DELETE remove.
Autenticação — como o outro sistema confirma que é você chamando, normalmente por token ou chave.
Montando a integração
Comece editando o fluxo:
Adicione o bloco de integração:
Escolha o método HTTP:
Informe a URL da requisição:
Configure os cabeçalhos, se o sistema exigir autenticação:
E o corpo da requisição, em JSON:
Boas práticas
Teste a chamada fora antes. Confirme que a requisição funciona por outra ferramenta antes de montá-la no fluxo. Depurar dentro do bot é mais lento.
Trate o caminho do erro. O sistema externo pode estar fora do ar ou não encontrar o dado. O fluxo precisa de uma saída para esses casos — normalmente, encaminhar para um atendente.
Não peça dado que você já tem. Se o CPF já está no cadastro do contato, use o que está lá em vez de perguntar de novo.
Enquanto a API não responde, o cliente fica esperando. Se o sistema de destino costuma demorar, avise antes — uma mensagem do tipo “só um instante, estou consultando” muda a percepção.
Alternativa
O workflow também tem um bloco de integração, com a mesma capacidade de chamar APIs. A diferença é que ele roda nos bastidores, sem depender de conversa acontecendo.