Envio de mensagem por API com a Botdesigner

Criada por Guilherme Bueno da Rosa, Modificado em Ter, 10 Jun, 2025 na (o) 9:56 AM por Guilherme Bueno da Rosa

Nesse artigo vamos entender o que é uma API e como integrar com a Botdesigner.

O que é API ?

API é um termo técnico usado no meio da tecnologia para descrever uma interface de integração entre dois sistemas, nesse caso um sistema usado internamente (Sistema de gestão, ERP, automação de marketing, sistema de Telefonia/VOIP/URA, etc) pela instituição de saúde que irá se conectar a Botdesigner por meio de uma API para envio de mensagem. Cada sistema pode possuir diversas APIs para diversos objetivos, o que nos leva a próxima pergunta.

Para que serve a API de envio de mensagens da Botdesigner?

Após o entendimento sobre o que é uma API é necessário entender que cada API tem um objetivo, no caso da API de envio de mensagens da Botdesigner o objetivo é permitir que algum sistema utilizado internamente pela instituição precise se comunicar com paciente pelo WhatsApp. Para exemplificar as possibilidades de uso da API vamos ver alguns casos em que a API de envio de mensagens da Botdesigner ajuda a instituição a melhorar a comunicação com o paciente:

1 - Telefonia(VOIP/URA): Em casos onde o paciente está buscando atendimento pelo telefone e não existem agentes para atendê-lo, é possível apresentar a opção de falar pelo WhatsApp. 


Por exemplo: ‘digite 1 para ser atendido pelo whatsapp ou digite 2 para continuar na fila de espera’ e caso o paciente digite 1, nesse momento o sistema da telefonia se comunica com a API de envio de mensagens da Botdesigner via programação e então é feito o disparo da mensagem, após isso o chatbot da instituição assume o atendimento. 


Outro caso, ainda na telefonia, é relacionado a tentar centralizar em apenas um canal de comunicação as interações com paciente. Para isso é apresentado já no início do atendimento a seguinte mensagem: ‘digite 1 para ser atendido pelo WhatsApp ou digite 2 para continuar atendimento pelo telefone’ a fim de incentivar o paciente a ser atendido pelo WhatsApp e diminuir a demanda pelo call center.

2 - Lembretes: a clínica pode enviar mensagens de lembretes aos pacientes. 


Por exemplo: ‘Seu exame está pronto no site http://site.da.instituicao’ ou também a instituição pode querer incentivar os pacientes a marcar uma consulta baseado na rotina do paciente, como no exemplo: ‘Vimos que faz um tempo que não faz seus exames de rotina, deseja marcar uma consulta?’, o que leva a uma comunicação personalizada com paciente e aumento de receita para instituição.


Para isso é necessário que dentro do sistema de gerenciamento da instituição seja desenvolvido uma lógica para buscar todos pacientes que tenham que receber essas mensagens de lembrete e fazer a comunicação pela API de envio de mensagens da Botdesigner.

Os casos de uso da API de envio de mensagens da Botdesigner são infinitos, qualquer comunicação que a instituição deseja fazer com o paciente é possível, e abaixo vamos ver como é feita a implantação de uma integração por API.

Parte técnica e implantação

Acima mostramos alguns exemplos de casos de uso da nossa API, é importante lembrar que a instituição é livre para identificar as comunicações que fazem sentido para seus pacientes. Após identificar a comunicação com o paciente que a instituição deseja fazer, o próximo e mais importante passo para sucesso na implantação do projeto é analisar junto aos seus fornecedores de serviço (telefonia, sistema de gestão, etc) a possibilidade de criar a integração com a API de envio de mensagens da Botdesigner. Nem todos os sistemas permitem integração via API.

Após a instituição conversar com seus fornecedores e receberem resposta positiva sobre a integração por API, a instituição deve comunicar a Botdesginer através de seu gerente de contas, que deseja fazer a integração. Após comunicá-lo, o gerente irá instruir a instituição a fazer contato entre a equipe técnica da Botdesigner e a equipe técnica do fornecedor para auxiliar a instituição, e o fornecedor no entendimento do caso de uso e implantação do projeto.

Caso os fornecedores ou a própria instituição tenham alguma dúvida sobre como funciona a integração, não hesite em chamar seu gerente de contas, ele estará pronto para tirar qualquer dúvida e instruir melhor sobre a implantação.

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo