Medicina Direta
Conectar a SM Click ao Medicina Direta.
Envio automático de mensagens a partir do sistema Medicina Direta.
O que é o Medicina Direta
O Medicina Direta é um sistema de gestão de clínicas, onde ficam a agenda, os pacientes e os atendimentos.
Para que serve a integração
A integração consulta a agenda do Medicina Direta na rotina que você define e envia ao paciente, pelo WhatsApp, a mensagem sobre a consulta marcada, para ele confirmar ou avisar que não vai. Isso reduz faltas e a equipe não precisa ligar ou mandar mensagem paciente por paciente.
Requisitos
Uma instância ativa na SM Click, para enviar as mensagens. A instância está disponível no plano Gamma ou pode ser adquirida separadamente no gerenciamento da assinatura.
As credenciais de acesso ao Medicina Direta:
- Login da API — login de acesso à API
- Senha da API — senha de acesso à API
Como configurar
No painel, acesse Integrações → Nativas e escolha o Medicina Direta. Informe as credenciais acima e defina as regras de envio.
Para indicar a instância que fará o envio:
- Acesse a página Home da SM Click.
- Localize a instância que será utilizada na integração.
- Clique em Copiar token.
- Cole o token no campo Instância que enviará a mensagem.
Envio por API Oficial
Quando a instância utilizar a API Oficial, informe também no campo ID do Template o ID de um template criado previamente. Nesse caso, não preencha o campo Mensagem: o conteúdo do envio já está configurado no template.
Criação de Template para Integração
Para enviar lembretes da Medicina Direta por uma instância da API Oficial, crie um template seguindo o processo padrão. Recomendamos a categoria Utilidade, o tipo Mensagem e um nome que identifique o uso na integração. O cabeçalho e o rodapé são opcionais.
No corpo, use variáveis no formato {{1}}, {{2}} e assim por diante. No exemplo de
cada variável, informe somente o nome do placeholder, sem as chaves: data, hora,
nomeMedico, nomeUnidade, enderecoUnidade, titulo, observacao, nome e
celular.
Adicione dois botões do tipo Resposta Rápida: um com o texto Sim, confirmar e outro com o texto Não, cancelar. Salve o template e informe seu ID na integração, deixando o campo Mensagem vazio.
Regras de envio
Você configura quantos dias antes ou depois do vencimento a mensagem sai, além dos dias da semana e do horário.
Como funciona o campo de dias
Em cada regra, o campo Dias a partir de hoje diz em relação à consulta quando a mensagem sai. O número é contado a partir de hoje: -1 é um dia antes da consulta, 0 é o próprio dia e 1 é um dia depois.
| Valor | Quando a mensagem sai | Exemplo (hoje é dia 10) |
|---|---|---|
| -1 | 1 dia antes da consulta (lembrete de véspera) | Consultas marcadas para o dia 11 |
| 0 | No dia da consulta | Consultas marcadas para hoje, dia 10 |
| 1 | 1 dia depois da consulta (por exemplo, para saber como foi) | Consultas que foram ontem, dia 9 |
Para lembrar com mais antecedência, use outros números: -3 avisa três dias antes. Cada regra tem o seu próprio texto, então dá para combinar, por exemplo, um lembrete três dias antes (-3), um de véspera (-1) e uma confirmação no dia (0).
O envio de Aniversariantes não usa essa regra: ele não tem campo de dias e a mensagem sai sempre no dia do aniversário.
As mensagens só saem nos dias da semana e no horário que você marcou na rotina. Se a rotina não roda no sábado, uma consulta de sábado que usa a regra 0 não recebe o aviso.
A recomendação é disparar em dias úteis, de segunda a sexta, entre 8h e 17h. Cobrança que chega de madrugada ou no domingo irrita, e irritação vira denúncia — que prejudica seu número.
Variáveis da mensagem
A mensagem enviada é escrita por você, e pode trazer dados do sistema integrado. Basta incluir a variável no texto: na hora do envio, ela é trocada pelo valor daquele cliente.
| Variável | O que traz |
|---|---|
{data} | A data da consulta, no padrão DD/MM/YYYY |
{hora} | O horário da consulta |
{nomeMedico} | O nome do profissional responsável pelo atendimento |
{nomeUnidade} | O nome da unidade de atendimento |
{enderecoUnidade} | O endereço completo da unidade de atendimento |
{titulo} | O título do agendamento |
{observacao} | As observações do agendamento |
{nome} | O nome do paciente cadastrado na Medicina Direta |
{celular} | O número do celular do paciente cadastrado na Medicina Direta |
Uma mensagem com variáveis parece pessoal, e não um disparo automático. Com as variáveis desta integração, algo como:
Olá {nome}, em {data}.
Sem elas, sobra o texto genérico que o cliente ignora.
Se parar de funcionar
O motivo mais comum é credencial expirada. Veja recarregar tokens.
Se o problema for a mensagem não chegar ao cliente, o retorno costuma vir da Meta — consulte erros mais comuns.
Atualizado em