Manuais:UniNFe/EnviandoXMLMessageBroker

Como utilizar o serviço do uMessenger?

Após realizar a configuração do uMessenger no UniNFe, vamos consumir o serviço de envio livre de mensagens. Bora conferir?

Envio livre de mensagens

O serviço do UniNFe é consumido por meio da troca de arquivos. Criamos um exemplo em XML para ilustrar esse processo. Para enviar, gere o arquivo na pasta de envio com o nome e formato indicados a seguir.

MensagemASerEnviada-mb.xml

MensagemASerEnviada	Conteúdo livre
-mb.xml	Conteúdo fixo. Sempre será "-mb.xml"

O nome do arquivo de retorno é o mesmo do arquivo enviado, alterando apenas o prefixo final, veja:

MensagemASerEnviada-ret-mb.xml (se tudo ocorreu bem)

ou

MensagemASerEnviada-ret-mb.err (se houve algum erro)

---

Estrutura do XML de envio

A estrutura de envio é compacta; vamos conferir.

<?xml version="1.0" encoding="utf-8"?>
<uMessenger versao="1.00">
   <SendTextMessage>
      <To>5544991423078</To>
      <Text>*Olá!*\r\n\r\nEu sou uma _mensagem_ de teste 🌜\r\n\r\n- Eu sou mais\r\n- Eu sou mais 1\r\n\r\nhttps://www.unimake.com.br</Text>
      <Testing>true</Testing>
      <UseHomologServer>true</UseHomologServer>
   </SendTextMessage>
</uMessenger>

• Legenda:
  • A tag <To> é o número do WhatsApp para onde será enviada a mensagem sendo uma tag obrigatória;
  • A tag <Text> Texto livre a ser enviado ao destinatário da mensagem;
  • A tag <Testing> é o que indica se é ambiente de teste ou não (True: ambiente de teste, False: ambiente de produção);
  • A tag <UseHomologServer> é uma tag opcional no XML tendo o valor padrão false. Só utilize quando é necessário fazer testes para possibilitar DEBUG do lado do eBank, naturalmente isso só pode ocorrer se um desenvolvedor do eBank solicitar esta tag no XML para facilitar depuração de código.

---

XML de retorno do envio: O que fazer?

Para verificar se a mensagem foi enviada, seu ERP deve verificar as informações no XML de retorno. Esse XML será gerado na pasta de retorno com o nome a seguir:

MensagemASerEnviada-ret-mb.xml

E sua estrutura é a seguinte:

<?xml version="1.0" encoding="utf-8"?>
<MessageBrokerResponse>
   <Status>1</Status>
   <Motivo>Mensagem enviada com sucesso.</Motivo>
   <messageID>wamid.HBgMNTU0NDkxNDIzMDc4FQIAERgSMjAyQTNGMDczMjhGMUE0NTI1AA==</messageID>
</MessageBrokerResponse>

• Legenda:
  • A tag <Status> é o status da mensagem tendo os valores:
    • 1 = Mensagem enviada com sucesso.
  • A tag <Motivo> é a descrição do status;
  • A tag <messageID> é o ID da mensagem enviada.

Veja também

• O que é o MessageBroker?
• Como configurar o MessageBroker no UniNFe?