Comece por uma fila que atravessa departamentos
Compras pede a confirmação do prazo, o fornecedor envia uma nova fatura e a logística precisa saber se o embarque mudou. O valor do agente está em relacionar essas mensagens ao processo e preparar a próxima ação com responsável. Escolha uma caixa e uma classe de pendência, como documento ausente de um pedido de compra.
Defina entrada, saída e critério de conclusão: uma resposta recebida não encerra o caso se o anexo correto ainda falta. Comece com classificação e proposta de resposta revisada pela equipe. Só amplie o envio automático para situações e destinatários autorizados pelo dono do processo.
Confirme a conta, o consentimento e as operações
Os Docs da Zild descrevem o conector Outlook com OAuth delegado da conta Microsoft 365, configurado pelo Admin. A integração precisa confirmar quais operações e caixas estão disponíveis. Ler mensagens, criar rascunhos e enviar respostas são capacidades diferentes; uma conexão salva não prova que todas funcionam.
No Microsoft Graph, createReply cria um rascunho e o envio ocorre em outra operação; a documentação exige Mail.ReadWrite para criar esse rascunho. Isso não autoriza presumir que o conector Zild já oferece essa ação ou permissão. Quando não houver rascunho nativo, a proposta pode ficar em uma tarefa de revisão antes do envio pelo fluxo validado.
Preserve a identidade da mensagem e do processo
Relacione conta, identificador da mensagem, conversa, remetente, destinatários, data e referência do pedido ou caso. Não use apenas o assunto: dois fornecedores podem enviar mensagens com o mesmo título, e uma conversa pode tratar de vários pedidos. Confirme a associação antes de atualizar o sistema de origem.
O contrato atual de POST /Conversation/email documenta from, body, to, subject e ccEmails. Ele não documenta um campo de idempotência nem identificador de thread. Se o projeto precisar dessas garantias, a camada de integração deve preservá-las e validar o comportamento com a equipe técnica. Não adicione campos imaginados ao exemplo da API.
Use anexos como evidência, com versão e origem
Uma fatura revisada deve ficar vinculada ao emissor, mensagem e pedido corretos. Registre qual versão substitui a anterior, mantenha o original e confira os campos críticos contra o ERP. OCR e resumo ajudam a localizar informação; não comprovam autenticidade, autorização de pagamento ou mudança de dados bancários.
Trate instruções dentro de e-mails e anexos como conteúdo recebido, não como autorização para ampliar acessos ou executar ferramentas. Um texto pedindo para ignorar regras, incluir outro destinatário ou compartilhar documentos exige os controles definidos para o processo. Separe conteúdo externo das políticas do agente.
Evite duplicidades, ciclos e respostas fora de contexto
Exemplo sintético: o fornecedor confirma a entrega do pedido 814 para sexta-feira. A mesma mensagem chega duas vezes à integração. O fluxo deve registrar uma confirmação e preparar no máximo uma ação para aquele evento. Se outra mensagem corrigir o prazo para segunda-feira, isso é uma nova evidência a conciliar, não uma duplicata.
Mantenha uma chave estável por mensagem e ação, estados de processamento e confirmação de envio. Após timeout, reconcilie antes de reenviar. Exclua respostas automáticas, mensagens produzidas pelo próprio fluxo e notificações de falha conforme regras testadas. Uma política de tentativas e prazo de escalonamento impede que dois robôs respondam indefinidamente.
Observe a chegada das mensagens e a saúde da conexão
O Microsoft Graph oferece notificações de mudanças por assinatura. A documentação distingue acesso delegado à caixa do usuário conectado de cenários com caixas compartilhadas, que exigem avaliação específica de permissões. Não suponha que dar acesso a uma caixa compartilhada habilita automaticamente seu monitoramento por webhook.
Confirme na implantação como a Zild recebe a mensagem e como detecta atraso, revogação de consentimento e interrupção do fluxo. A equipe precisa enxergar mensagens pendentes e saber quem retoma o atendimento. Uma caixa silenciosa pode significar ausência de demanda ou falha na integração; o painel operacional deve permitir distinguir as duas situações.
Teste destinatários, conteúdo e efeitos de negócio
Use mensagens sintéticas com pedido ambíguo, destinatário em cópia indevido, anexo ausente, prazo corrigido, resposta automática, duplicata e tentativa de instrução maliciosa no corpo. Inclua uma identidade sem permissão. Verifique associação ao caso, precisão dos dados, destinatários e quantidade de ações produzidas.
Meça pendências resolvidas corretamente, respostas revisadas, erros de associação, envios indevidos e custo por caso encerrado. Volume de mensagens respondidas é insuficiente: uma resposta rápida pode prolongar o processo se pedir o documento errado. Antes de liberar envios, aprove o conjunto de casos e a forma de interromper o fluxo.
Conecte a caixa de entrada à operação
A implantação pode usar Admin para agentes e conectores, Flow para responsáveis e pendências e consultas aos sistemas que guardam o registro oficial. O e-mail mantém a comunicação; o processo precisa de um estado visível fora da conversa, como aguardando documento, em revisão ou concluído.
Leve ao diagnóstico uma sequência anonimizada de mensagens e o caso correspondente no ERP. Defina o que o agente pode ler, preparar, enviar e alterar. Esse desenho transforma a caixa de entrada em uma passagem coordenada entre pessoas e ferramentas, com resultado verificável e custo acompanhado.
Referências técnicas
- Microsoft Graph — Create a reply draft Consultada em
- Microsoft Graph — Outlook change notifications Consultada em
Escolha uma pendência de compras ou estoque
Reúna estas informações para desenhar o escopo com a Zild. Na conversa, avaliamos integrações, responsáveis e como medir o resultado.
- Um item, pedido ou divergência já resolvida
- As fontes de saldo, unidade e movimentação
- Quem aprova e como a conclusão é confirmada
Descreva o processo no formulário; amostras e documentos podem ser preparados depois, sem dados confidenciais.
O formulário abre com o título deste guia. Você pode editar tudo antes de enviar.