Conhecendo as integrações do Tactium x NAJA

Objetivo

Este documento apresenta a arquitetura, o funcionamento e as principais características da integração entre a plataforma TACTIUM e o sistema NAJA.

A integração permite que eventos gerados no NAJA acionem automaticamente o envio de notificações aos pacientes via WhatsApp por meio da plataforma TACTIUM. Além disso, no fluxo de Confirmação de Agendamento, a resposta do paciente é processada pelo ChatBot do TACTIUM e registrada automaticamente no sistema NAJA.

Pré-requisitos

Antes da utilização da integração, é necessário realizar as seguintes configurações:

• Configurar uma campanha no TACTIUM para cada tipo de notificação.
• Associar cada campanha ao respectivo template aprovado na Meta e cadastrado na GupShup.
• Configurar as credenciais de autenticação da API.
• Disponibilizar os endpoints de integração entre as plataformas.

Campanhas

Devem ser cadastradas as seguintes campanhas:

Cada campanha deve possuir as seguintes configurações:

• Horário de vigência;
• Período de execução;
• Status Ativa.

Importante: Caso qualquer uma dessas configurações esteja incorreta, os disparos poderão não ser executados.

Para mais informações sobre a criação de campanhas, consulte o manual Criando campanhas do Tactium OMNI.

Templates e Variáveis

Cada campanha utiliza um template previamente aprovado na Meta e cadastrado no broker.

Durante o disparo, o sistema NAJA envia ao TACTIUM os valores das variáveis por meio do parâmetro variaveis, responsável pela personalização da mensagem.

Exemplos de mensagens, destacando as variáveis:

Aviso Virtual de Agendamento

Olá João. Seu exame foi agendado com sucesso. Para visualizar os detalhes do agendamento, acesse: https://…

Confirmação de Agendamento

Olá João, gostaríamos de confirmar sua presença.

Data: 12/12/2026
Horário: 14:14

Importante trazer sua guia original, documento de identificação e exames anteriores.

[Confirmar] | [Cancelar]

Cartão de Entrega

Olá João.

Seu exame de Sangue foi agendado.

Guarde este link, pois ele será utilizado posteriormente para consultar o resultado do exame:

https://…

Assim que o resultado estiver disponível, você receberá uma nova notificação.

Aviso de Laudo Pronto

Olá João.

O resultado do seu exame já está disponível.

Acesse o link abaixo e utilize seu login e senha para consultar o laudo.

https://…

Importante

As variáveis devem ser enviadas exatamente na mesma ordem em que foram cadastradas no template da Meta. A alteração da ordem poderá resultar em mensagens com informações incorretas.

Para mais informações sobre a criação e configuração de templates, consulte o manual correspondente ao broker utilizado:

• GupShup: Configurando Template do GupShup para ativo do WhatsApp no Tactium OMNI.
• Twilio: Configurando Template na Twilio para ativo do WhatsApp no Tactium OMNI.

Visão Geral da Integração

A integração é baseada em uma Régua de Atendimento, configurada no sistema NAJA, responsável por definir quando cada notificação deve ser enviada ao paciente.

Quando uma regra é executada, o NAJA realiza uma chamada à API do TACTIUM solicitando o envio da mensagem correspondente.

Após receber a requisição, o TACTIUM:

1. Valida os dados recebidos;
2. Processa a solicitação;
3. Realiza o envio da mensagem via WhatsApp;
4. Processa a resposta do paciente, quando aplicável.

Fluxos disponíveis

Observação: Apenas o fluxo Confirmação de Agendamento possui interação com o paciente. Os demais templates têm caráter exclusivamente informativo.

APIs de Integração

A comunicação entre as plataformas é realizada por meio das APIs:

API – TACTIUM

A API TACTIUM disponibiliza os serviços de autenticação e envio das notificações.

Autenticação

Antes de consumir qualquer serviço da API é necessário obter um Bearer Token.

Endpoint

POST /administracao/autenticar

Exemplo

{
    "usuario": "softium",
    "senha": "123456",
    "urlEventos": "https://hostname/app/service",
    "modeloEventos": "webhook"
}

O token retornado deverá ser enviado no cabeçalho Authorization das demais requisições.

Disparo de Mensagens

Responsável pelo envio das notificações via WhatsApp utilizando uma campanha previamente configurada.

Endpoint

POST /WhatsApp/disparar

Exemplo

{
    "codCampanha": 99,
    "codExterno": "01010101001",
    "variaveis": [
        "valor1",
        "valor2",
        "valor3"
    ],
    "ddi": "55",
    "ddd": 85,
    "fone": 999999999,
    "nome": "João",
    "dataLimite": "2025-09-25T14:48:33.788Z"
}

Principais parâmetros

API – NAJA

A API do NAJA é utilizada exclusivamente durante o fluxo de Confirmação de Agendamento.

Após a resposta do paciente, o ChatBot do TACTIUM aciona uma Procedure desenvolvida pela TACTIUM, responsável por encapsular toda a comunicação com a API do NAJA.

Essa Procedure recebe o codExterno informado no disparo da mensagem, identifica o agendamento correspondente e realiza automaticamente a confirmação ou o cancelamento no sistema NAJA.

Todo o processo de consumo da API, atualização do agendamento e tratamento de exceções é executado internamente pela Procedure, não sendo necessária qualquer implementação adicional no ChatBot.

Fluxo da Integração

O diagrama abaixo apresenta o fluxo completo da integração, desde a geração do evento no sistema NAJA até o envio da notificação ao paciente e, quando aplicável, o retorno da interação para atualização automática do agendamento.

Monitoramento dos Disparos

Todos os disparos podem ser acompanhados por meio do relatório Produtividade de Campanhas, disponível no Omni Monitor.

O relatório permite consultar, entre outras informações:

• Data e hora do disparo;
• Campanha utilizada;
• Paciente destinatário;
• Status do envio;
• Situação do processamento;
• Código externo (codExterno);
• Informações operacionais do processamento.

Para mais informações sobre o relatório, filtros e indicadores disponíveis, consulte a documentação do Relatório de Produtividade de Campanhas.