Ir para o conteúdo
Gestor › Integrações › Nativas › Financeiro e cobrança

Conexa

Avisar seus clientes da Conexa sobre cobranças pelo WhatsApp.

A integração lê as cobranças da Conexa e envia mensagem aos clientes nos dias que você definir — antes do vencimento, no dia, ou depois.

Esta é a integração de cobrança, não de consulta

Apesar de a Conexa ser um sistema de saúde, o que esta integração notifica são cobranças. Para lembrete de consulta, veja as demais integrações desta seção.

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.

O token de acesso à Conexa, obtido no próprio sistema.

Como configurar

No painel, acesse Integrações → Nativas e escolha a Conexa.

A credencial

Um campo só: Token de acesso à Conexa.

A rotina

CampoO que define
Dias da SemanaEm quais dias a rotina roda. Ao menos um é obrigatório
HorárioA que horas ela busca as cobranças
Fuso HorárioBase para os dias e o horário acima
Intervalo entre mensagensTempo mínimo e máximo, em segundos, entre um envio e o seguinte

O envio

CampoO que define
Instância que enviará as mensagensDe qual canal as mensagens saem
ID do TemplateSó para instância da API Oficial. Deixe vazio nas demais

Para preencher Instância que enviará as mensagens, acesse a Home da SM Click, localize a instância, clique em Copiar token e cole o valor nesse campo.

Envio por API Oficial

Quando a instância utilizar a API Oficial, informe também o ID do Template criado previamente. Nesse caso, não preencha o campo Mensagem, pois o conteúdo já está configurado no template.

Criação de Template para Integração

Para enviar cobranças da Conexa 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: nome, dataVencimento, valor, linhaDigitavel, linkBoleto e linkCobranca.

Para o botão da cobrança, adicione um botão Acessar Site, use a URL https://consultec.conexa.app/index.php?r=cobranca/boleto/&id={{1}}, informe bb83f145f2044effc455f16a8fce28da como exemplo da variável da URL e escolha um texto como Acessar Boleto. Salve o template e informe seu ID na integração, deixando o campo Mensagem vazio.

Regras de envio

Cada regra combina quantos dias antes ou depois do vencimento a mensagem sai e o texto dela. É preciso ter ao menos uma.

Cada regra pode ainda ter um template próprio, o que permite usar modelos diferentes para o aviso de véspera e para a cobrança em atraso.

As variáveis disponíveis aparecem na própria tela, junto do campo de mensagem.

Variáveis da mensagem

Em mensagens comuns, quando a instância não utiliza a API Oficial, você pode incluir as variáveis com as chaves no texto da mensagem. Na API Oficial, utilize o template configurado acima.

VariávelO que traz
{nome}O nome do cliente
{dataVencimento}A data de vencimento da cobrança
{valor}O valor da cobrança
{linhaDigitavel}A linha digitável do boleto
{linkBoleto}O link do boleto
{linkCobranca}O link da cobrança
Envie em horário comercial

Cobrança que chega de madrugada ou no domingo irrita, e irritação vira denúncia — que prejudica seu número.

Dias úteis, entre 8h e 17h, é o que costuma funcionar.

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