Quando um chamado (ocorrência) é atendido no Sistema Multidados, é feita a mudança do Status atual do chamado para refletir a ação executada. Durante a mudança de Status, podemos executar uma série de ações como por exemplo: Envio de email, sms ou whatsapp, a Integração Externa entre outras.A Integração Externa é um recurso do CRM que permite o envio automático de informações sempre que uma Ocorrência é movimentada para um determinado Status. Esse envio é feito por meio de uma requisição HTTP POST, contendo um JSON com os dados da Ocorrência, do Cliente e do Contrato/Projeto, além de eventuais campos adicionais configurados.
POST
A integração é disparada automaticamente sempre que uma Ocorrência atinge um Status que tenha a Integração Externa configurada. Esse mecanismo permite que sistemas externos recebam e processem essas informações em tempo real.
A Integração Externa pode ser utilizada para diversos fins, como:
Esse recurso possibilita uma maior eficiência operacional, garantindo que informações críticas sejam compartilhadas de forma automática e padronizada.
Para utilizar a Integração Externa, é necessário atender aos seguintes pré-requisitos:
Antes de configurar a Integração Externa, o plugin de integração deve ser liberado no sistema. Para isso, é necessário entrar em contato com o Suporte Multidados e solicitar a ativação do recurso.
A configuração da Integração Externa deve ser realizada por usuários com conhecimento técnico adequado, pois o envio dos dados pode incluir informações sensíveis dos clientes.
Uma vez liberado pelo Suporte, o recurso ficará disponível na aba Integração Externa dentro do cadastro de Status no CRM.
A configuração da Integração Externa é realizada dentro do cadastro de Status no CRM. Apenas usuários com experiência técnica devem realizar essa configuração, pois ela envolve o envio de dados sensíveis para sistemas externos.
Para configurar a integração:
Dentro da aba Integração Externa, os seguintes campos estarão disponíveis:
Após configurar os parâmetros e salvar as alterações, a integração será ativada e disparará sempre que uma Ocorrência for movida para o Status configurado.
A Integração Externa do CRM envia os dados no formato JSON, com um array de nível único. O conteúdo enviado depende da configuração dos Parâmetros da Integração, permitindo a inclusão de informações da Ocorrência, do Cliente, do Contrato/Projeto e de Campos Adicionais.
Os dados são enviados via POST em um JSON simples, sem estrutura aninhada. Cada campo configurado na integração será enviado como uma chave dentro do objeto JSON.
Os seguintes grupos de informações podem ser utilizados para compor o payload da integração:
(Exemplo fictício — a estrutura real dependerá da configuração feita no CRM)
{ "status": "Concluído", "divisao": "Técnica", "solicitacao": "Reparo Elétrico", "sla": "24 horas", "cliente_nome": "João da Silva", "cliente_documento": "123.456.789-00", "telefone": "(11) 99999-9999", "endereco": "Rua Exemplo, 123 - SP", "contrato_codigo": "CTR-2024-001", "empreendimento": "Residencial Alfa", "bloco": "B", "unidade": "101", "usuario_logado": "Administrador" }
A Integração Externa não realiza validação de cabeçalhos ou autenticação nativa. O envio dos dados ocorre de forma direta, e o resultado da requisição é registrado dentro da Ocorrência.
Independente do sucesso ou falha na requisição, o resultado do envio é registrado automaticamente na aba de Narrativas da Ocorrência. Isso permite que os usuários acompanhem o histórico da integração diretamente no CRM.
O registro pode incluir:
A Integração Externa não possui um mecanismo automático de reenvio. Caso um envio falhe, será necessário ajustar a configuração e realizar a movimentação da Ocorrência novamente para disparar a integração manualmente.
A Integração Externa lida com dados sensíveis de clientes e contratos, exigindo cuidados especiais para garantir a segurança das informações e evitar acessos indevidos.
Em casos onde o sistema de destino exige um formato mais complexo de dados, como arrays multinível ou validação de cabeçalhos, é possível criar uma página intermediária para atuar como um meio de campo entre a Integração Externa e o sistema final.
A Integração Externa do CRM é uma ferramenta poderosa para automatizar a troca de informações com sistemas externos. No entanto, para garantir seu funcionamento correto e seguro, é fundamental que sua configuração seja realizada com atenção às diretrizes apresentadas neste manual.
Caso haja dúvidas ou necessidade de suporte técnico, entre em contato com a equipe da Multidados através dos canais oficiais.