XMPP e VoIP – um exemplo prático

Integrar XMPP com VoIP tem sido nos últimos anos um dos meus maiores objetivos. A criação de uma solução integrada de comunicação realtime com open source passa por estas duas tecnologias, e fazê-las conversar entre si (de forma útil) sempre foi um dos meus desejos.
Desde que comecei a trabalhar com Asterisk e Openfire, há uns 9 anos atrás, tenho pensado em criar algo fazendo uso desta integração e, após a versão 11 do Asterisk,  aparentemente tal objetivo começou a ficar mais próximo.
Usando AGIs em python, comecei a desenvolver uma “ferramenta” que permite que o usuário realize uma série de ações através da sua conta xmpp no seu cliente de IM preferido (ex: Pidgin). Por enquanto o software já dispõe de:

• Envio de mensagem SIP para ramal
• Envio de SMS
• Ativação/desativação de DND
• Ativação/desativação de desvio
• Login/logoff de fila
• Obtenção de informações sobre o ramal
• Obtenção de informações sobre fila
• Envio de mensagem XMPP para todos os usuários logados em uma determinada fila
• Exibição de  informações dos peers SIP e IAX
• Outros recursos ainda em desevolvimento.

Para que tudo isso funcione é preciso também realizar configurações e/ou alterações no DB do Asterisk, no AMI (fonte principal das ações) e no plano de discagem. Isso é necessário para que seja possível garantir o armazenamento de outros dados (JID) e para a realização de operações pertinentes aos recursos da ferramenta (controle do DND e desvio, por exemplo).
Minha intenção é que assim que a ferramenta esteja mais madura, a mesma seja implementada no servidor XMPP do Mundo Open Source para que os leitores possam experimentá-la e testá-la, para posterior lançamento do código fonte.
Mas, enquanto a mesma ainda está na fala pré alpha ( ), gostaria de já compartilhar, de forma prática, essa possibilidade de integração para que vocês também possam construir suas soluções, e, quem sabe, possamos trocar ideias e desenvolver novos recursos e ferramentas juntos.
Pré requisitos
Para que você possa implementar o aqui proposto é preciso ter os seguintes recursos disponíveis:

• Servidor Asterisk 11 ou superior funcional e com suporte a XMPP (res_xmpp)
• Servidor XMPP (sugiro Openfire 3.9.3, mas outros podem ser usados) funcional
• Uma conta para o Asterisk no seu servidor XMPP

Por onde começar?
Para começar e preciso fazer o Asterisk se comunicar com seu servidor XMPP. Para isso edite o arquivo /etc/asterisk/xmpp.conf e crie uma sessão para o mesmo. Ex:

[asterisk]
type=client
serverhost=xmpp.meudominio.com.br
username=asterisk@xmpp.meudominio.com.br
secret=senha
priority=1
usetls=yes
port=5222
usesasl=yes
buddy=marcelo@xmpp.meudominio.com.br
status=available
statusmessage=”Servidor Asterisk”
sendtodialplan=yes
context=from_xmpp
keepalive=yes

Edite também o arquivo /etc/asterisk/extensions.conf e crie o contexto from_xmpp com o seguinte conteúdo:

[from_xmpp]
exten => s,1,NoOp(Mensagem XMPP)
same => n,NoOp(Para: ${MESSAGE(to)})
same => n,NoOp(de: ${MESSAGE(from)})
same => n,NoOp(Mensagem: ${MESSAGE(body)})
same => n,NoOp(Enviando mensagem SIP)
; AGI que processa a mensagem enviada e obtém as variáveis
; ${XMPP_MSG} – texto da mensagem
; ${XMPP_SIPDEST} – ramal do destinatário
; ${XMPP_SIPORIG}  - ramal do remetente
same => n,agi(process_xmpp_msg.agi)
; Seta ${XMPPRESOURCE} = nome da seção no arquivo xmpp.conf (pode ser uma global)
same => n,Set(XMPPRESOURCE=asterisk)
same => n,Set(MESSAGE(body)=${XMPP_MSG})
same => n,MessageSend(sip:${XMPP_SIPDEST},sip:${XMPP_SIPORIG})
same => n,JabberSend(${XMPPRESOURCE},${MESSAGE(from):5},”Mensagem enviada. Status:${MESSAGE_SEND_STATUS}). )

E como usar?
Para se “comunicar” com seu Asterisk, basta mandar mensagens para o JID configurado no arquivo xmpp.conf (no caso, asterisk@xmpp.meudominio.com.br). Toda a mensagem será recebida no contexto configurado (no caso, from_xmpp) e armazenada na variável ${MESSAGE}, como pode-se observar no código acima.  O contexto de exemplo foi criado com vários comandos  NoOP para que você possa entender bem o que contém cada variável.
Atenção: como o intuito deste post é tratar especificamente da integração entre XMPP e VoIP, não foi listado o conteúdo do script process_xmpp_msg.agi, já que ele é basicamente usado para tratar texto e pesquisar dados no DB.
Exemplos de saída e logs
Envio via Pidgin:

(02:53:00 PM) marcelo@xmpp.meudominio.com.br/meuresource: msg 5010 Isso é um teste
(02:53:01 PM) asterisk@xmpp.meudominio.com.br: Mensagem enviada. Status: SUCCESS.

Logs do console do Asterisk:

– Executing [s@from_xmpp:1] NoOp(“Message/ast_msg_queue”, “Mensagem XMPP”) in new stack
– Executing [s@from_xmpp:2] NoOp(“Message/ast_msg_queue”, “Para: xmpp:asterisk@xmpp.meudominio.com.br”) in new stack
– Executing [s@from_xmpp:3] NoOp(“Message/ast_msg_queue”, “de: xmpp:marcelo@xmpp.meudominio.com.br/meuresource”) in new stack
– Executing [s@from_xmpp:4] NoOp(“Message/ast_msg_queue”, “Mensagem: msg 5010 Isso é um teste”) in new stack
– Executing [s@from_xmpp:10] NoOp(“Message/ast_msg_queue”, “Enviando mensagem SIP”) in new stack
– Executing [s@from_xmpp:11] Set(“Message/ast_msg_queue”, “MESSAGE(body)=Isso é um teste”) in new stack
– Executing [s@from_xmpp:12] MessageSend(“Message/ast_msg_queue”, “sip:5010,sip:5099″) in new stack
– Executing [s@from_xmpp:15] JabberSend(“Message/ast_msg_queue”, “asterisk,marcelo@xmpp.meudominio.com.br/meuresource,Mensagem enviada. Status: SUCCESS.”) in new stack

Espero  que vocês também consigam perceber o universo de possibilidades criado por esta integração. Fiquem à vontade para deixar seus comentários e/ou fazer contato para que possamos discutir o recurso mais a fundo.

Fonte: http://www.mundoopensource.com.br/xmpp-e-voip-um-exemplo-pratico/