Pular para o conteúdo
D-APITestar grátis

saas de saúde

WhatsApp para software de clínicas, com o número de cada clínica dentro da agenda

Coloque WhatsApp no seu software de clínicas: cada clínica conecta o próprio número, a agenda confirma consultas com um toque do paciente e a recepção liga pelo WhatsApp sem sair do sistema.

SaaS testa 14 dias com o time técnico ajudando na integração.

conexões na D-API
1.875
de uptime garantido em contrato
99,9%
datacenters no Brasil
4
por ligação de WhatsApp na API não-oficial
R$ 0
  • Confirmação que volta para a agenda

    O paciente escolhe confirmar, remarcar ou cancelar numa lista. A opção chega no webhook com o identificador que você definiu.

  • Uma conexão por unidade

    Rede com três endereços, três números. Cada unidade fala com os próprios pacientes, e o seu banco mantém tudo ligado à mesma clínica.

  • Ligação pelo WhatsApp da clínica

    Na API não-oficial, a recepção liga e atende chamadas de WhatsApp pelo seu sistema, sem custo extra por ligação.

  • Menos conteúdo sensível guardado

    Por conexão, dá para desligar o armazenamento do conteúdo das mensagens na D-API sem perder os webhooks.

Quem desenvolve software de gestão para clínicas médicas, odontológicas ou de terapia conhece a cena: a secretária passa a tarde no celular confirmando consulta por consulta, copiando horários da agenda para o WhatsApp e voltando com as respostas. Levar o WhatsApp para dentro do software de clínicas tira esse trabalho da mão dela e coloca na agenda. Cada clínica conecta o próprio número ao seu sistema, as mensagens saem a partir dos eventos da agenda e a resposta do paciente atualiza o horário sozinha.

Esta página mostra os fluxos que um SaaS de saúde consegue entregar com a D-API e os cuidados específicos de um segmento que lida com dado de paciente.

O número da clínica dentro do seu sistema

O paciente reconhece o número da clínica, e é desse número que a mensagem precisa sair. Na D-API, cada clínica ganha uma conexão própria, criada pelo seu backend com um sessionId que você controla, e o QR code aparece numa tela de configuração do seu produto. A recepção escaneia uma vez e a agenda passa a falar pelo WhatsApp da clínica.

Para redes com várias unidades, o desenho natural é uma conexão por unidade. A unidade do centro confirma as consultas dela, a do bairro confirma as suas, e o seu banco liga as duas à mesma conta de cliente. Como cada conexão é isolada, com IP dedicado, uma unidade que desconecta o aparelho não afeta as outras, e o evento connection.status avisa o seu sistema para pedir a reconexão.

Confirmação de consulta que atualiza a agenda

O fluxo que mais economiza tempo da recepção é a confirmação. Na véspera, o seu sistema envia uma mensagem interativa de lista com as opções, usando o identificador da consulta no rowId:

POST /api/v1/interactive/send/list
{
  "sessionId": "clinica-77-centro",
  "to": "5511999999999",
  "title": "Consulta amanhã, 14h30",
  "description": "Dra. Paula, Clínica Centro. Você confirma a sua presença?",
  "buttonText": "Responder",
  "sections": [{
    "title": "Sua consulta",
    "rows": [
      { "rowId": "cons-88213:confirmar", "title": "Confirmar presença" },
      { "rowId": "cons-88213:remarcar", "title": "Preciso remarcar" },
      { "rowId": "cons-88213:cancelar", "title": "Cancelar consulta" }
    ]
  }]
}

Quando o paciente toca numa opção, o webhook messages.received chega com type: "list_response" e o selected_row_id que você mandou. O seu handler separa o identificador da consulta da ação e atualiza o status na agenda. “Confirmar” marca o horário como confirmado, “remarcar” abre um fluxo de novos horários e “cancelar” libera a vaga para a lista de espera. A recepção só olha as exceções.

Orientações, endereço e documentos no momento certo

Boa parte das faltas e atrasos vem de informação que não chegou. O seu software já sabe que tipo de consulta ou exame está marcado, então pode mandar o conteúdo certo para cada caso:

  • Preparo de exame em PDF. POST /api/v1/messages/send/document envia o arquivo por URL ou base64, com fileName e caption. Jejum, suspensão de medicação e o que levar no dia saem junto do lembrete.
  • Endereço da unidade. POST /api/v1/messages/send/location manda latitude, longitude, nome e endereço, e o paciente abre o mapa direto da conversa.
  • Vídeo de orientação. Para pós-procedimento ou fisioterapia, send/video entrega o vídeo gravado pela própria clínica.

Fora do horário de atendimento, a mensagem que o paciente manda também tem destino. O seu sistema recebe pelo mesmo webhook e decide se responde com uma orientação automática ou se guarda para a recepção no dia seguinte.

Quando a mensagem não basta, a clínica liga

Tem paciente que não responde mensagem, mas atende ligação. Na API não-oficial, o seu software faz a chamada de WhatsApp pelo número da própria clínica, sem custo extra por ligação. O botão “ligar” fica na tela da agenda, ao lado do horário não confirmado. POST /api/v1/calls/place inicia a chamada, e os eventos call.ringing, call.connected, call.ended ou call.not_answered registram o resultado no histórico do paciente.

O caminho inverso também funciona. Com o recebimento de chamadas ligado na conexão, a ligação que o paciente faz para o WhatsApp da clínica aparece no seu sistema, e a recepcionista atende no navegador. O guia de receber ligações pela API mostra o fluxo de oferta, atendimento e áudio. Clínicas que preferem só mensagem podem recusar automaticamente com um texto como “Atendemos por aqui, pode escrever”.

Para o paciente que não está no WhatsApp ou não atendeu, a mesma conta oferece ligação telefônica com URA: a ligação toca um áudio gravado pela clínica e captura a tecla, e “pressione 1 para confirmar” volta como evento call.dtmf para o seu backend.

Consulta por vídeo com convite agendado

Clínicas que atendem a distância precisam mandar o link no horário certo. POST /api/v1/calls/send-event envia ao paciente um convite de chamada agendada, com title e scheduledTime. O convite pode criar um link de chamada do WhatsApp de áudio ou vídeo, com createCallLink, ou apontar para a URL de outra ferramenta de vídeo em customCallLinkUrl. O paciente abre o convite na conversa que já tem com a clínica.

Dado de paciente pede cuidado extra

Dado de saúde é dado pessoal sensível na LGPD, e isso deve orientar o que o seu software escreve no WhatsApp. Algumas práticas valem para qualquer clínica:

  • Mensagem mínima. Lembrete com data, horário, profissional e endereço resolve. Resultado de exame, diagnóstico e detalhe clínico ficam no portal ou no atendimento.
  • Conteúdo fora do armazenamento. POST /api/v1/sessions/{sessionId}/disable-message-storage-settings desliga, por conexão, a persistência do conteúdo das mensagens no banco da D-API. Os contatos continuam armazenados e os webhooks seguem funcionando, então o seu sistema recebe tudo e decide o que guarda.
  • Autorização no seu backend. A API key da sua conta enxerga todas as conexões. O seu código confere se a sessão pertence à clínica do usuário logado antes de cada envio ou consulta.

A lista de campos de cada evento recebido, incluindo respostas de lista e de botão, está na documentação da D-API.

API Oficial para a clínica que pedir

Algumas redes têm política de usar apenas a API Oficial da Meta. Para elas, a conexão nasce pelo Embedded Signup num popup hospedado pela D-API, e o seu código de envio continua o mesmo. A diferença é a regra da Meta: fora da janela de 24 horas desde a última mensagem do paciente, o lembrete precisa sair como template aprovado. Na prática, o lembrete de véspera vira um template de utilidade, e as tarifas da Meta são cobradas na conta Meta da própria clínica. A D-API cobra do seu SaaS o mesmo preço por conexão nas duas modalidades.

Por onde começar

Comece pelo fluxo de confirmação, porque é o que a clínica sente no primeiro dia. Crie uma conexão de teste, envie a lista para o seu próprio número e trate o list_response no webhook. Depois acrescente o PDF de preparo, o botão de ligação na agenda e, para quem não respondeu, a URA. A visão geral de como o WhatsApp entra em qualquer produto está na página de API de WhatsApp para SaaS.

Time D-API. Atualizado em .

Perguntas frequentes

Cada clínica precisa ter uma conta na D-API?

Não. O seu software tem uma conta e cria uma conexão por número de clínica ou de unidade. A clínica só escaneia o QR code dentro do seu sistema.

Posso usar o mesmo número que a recepção já usa no celular?

Na API não-oficial, sim: o número é conectado como um aparelho, e as mensagens enviadas pelo celular também chegam ao seu sistema no webhook messages.received, com fromMe: true. Na API Oficial, o modo de coexistência permite manter o app WhatsApp Business no mesmo número.

A D-API tem integração pronta com algum software de clínica?

Não. A D-API é a infraestrutura de WhatsApp, voz e SMS. A integração com a agenda é feita pelo seu software, chamando a API REST e tratando os webhooks.

Dá para fazer teleconsulta pela API?

A API envia um convite de chamada agendada com título e horário, criando um link de chamada do WhatsApp de áudio ou vídeo, ou usando a URL de outra ferramenta de vídeo que a clínica já usa.

E se o paciente não tiver WhatsApp naquele número?

Antes de enviar, você pode verificar o número com POST /api/v1/contacts/check. Para quem não está no WhatsApp, a mesma conta envia SMS ou faz uma ligação de URA.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.