Mudanças

=<font color=#2E8B57>'''Como utilizar o serviço do uMessenger?'''</font>= Após realizar a Tópico movido para [[Manuais:UniNFe/ConfigurandoMessageBrokerEnviandoXMLuMessenger|configuração do uMessenger no UniNFe]], vamos consumir Como utilizar o serviço de envio livre de mensagens. Bora conferir? ==<font color=#2E8B57>'''Envio de mensagens com ou sem arquivos'''</font>== Agora o ERP pode enviar mensagem para o WhatsApp através do UniNFe. Criamos um [https://www.unimake.com.br/uninfe/modelos.php?p=uMessenger exemplo em XML] para ilustrar esse processo. Para enviar, ERP deve gerar o arquivo na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de envio|pasta de envio]] com o nome e formato indicados a seguir: MensagemASerEnviada-mb.xml {| class="wikitable"|-||MensagemASerEnviada||Conteúdo livre|-| style="width: 120px;"|-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'') ---- ===<font color=#2E8B57>Estrutura do XML de envio</font>=== A estrutura de envio é compacta, vamos conferir. <pre><?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> <Files> <File> <FullPath>D:\Wandrey\OneDrive\Imagens\Capturas de tela\Screenpresso\ScreenShot_20250317_162121.png</FullPath> <Description>Texto ou descrição qualquer para acompanhar o arquivo</Description> <MediaType>1</MediaType> </File> <File> <FullPath>D:\Wandrey\OneDrive\Imagens\Capturas de tela\Screenpresso\ScreenShot_20250312_170821.png</FullPath> <Description>Texto ou descrição qualquer para acompanhar o arquivo</Description> <MediaType>1</MediaType> </File> </Files> </SendTextMessage></uMessenger></pre> * <font color=#2E8B57>'''Legenda:'''</font>** A tag '''<To>''' é o número do WhatsApp para onde será enviada a mensagem, <span style="color: red">'''sendo uma tag obrigatória'''</span>;** A tag '''<Text>''' é o 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 <font color="#FF0000">'''false'''</font>. Só utilize quando é necessário fazer testes para possibilitar DEBUG do lado do uMessenger, naturalmente isso só pode ocorrer se um desenvolvedor do eBank solicitar esta tag no XML para facilitar depuração de código;** O grupo '''<Files>''' é onde ficará as informações dos arquivos que serão enviados com <span style="color: red">'''LIMITE DE 10 ARQUIVOS'''</span>:*** O grupo '''<File>''' indica as informações de um arquivo específico que será enviado:**** A tag '''<FullPath>''' é o caminho do arquivo a ser enviado, <span style="color: red">'''sendo uma tag obrigatória'''</span>;**** A tag '''<Description>''' é o texto ou descrição que acompanhará o arquivo, não sendo obrigatória;**** A tag '''<MediaType>''' é o tipo da mídia que está sendo enviada com os valores: 0 para nenhum, 1 para imagem, 2 para documento, 3 para áudio e 4 para vídeo, não sendo obrigatória. ---- ===<font color=#2E8B57>XML de retorno do envio: O que fazer?</font>=== Para verificar se a mensagem foi enviada, seu ERP deve verificar as informações no XML de retorno. Esse XML será gerado na [[Manuais:UniNFe/Configurando o UniNFe/Configuracoes Empresas/ConfigAbaPastas/Pasta de retorno|pasta de retorno]] com o nome a seguir: MensagemASerEnviada-ret-mb.xml E sua estrutura é a seguinte: <pre><?xml version="1.0" encoding="utf-8"?><MessageBrokerResponse> <Status>1</Status> <Motivo>Mensagem enviada com sucesso.</Motivo> <messageID>wamid.HBgMNTU0NDkxNDIzMDc4FQIAERgSMjAyQTNGMDczMjhGMUE0NTI1AA==</messageID></MessageBrokerResponse></pre> * <font color=#2E8B57>'''Legenda:'''</font>** 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. =<font color=#2E8B57>'''Veja também'''</font>= * [[Manuais:Message.Broker/MessageBroker|O que é o MessageBroker?]]* [[Manuais:UniNFe/ConfigurandoMessageBroker|Como configurar o MessageBroker no UniNFe?]]