Protocolo CTI uTech/SEND MESSAGE
De uTech Tecnologia
(Diferença entre revisões)
(Criou página com '__TOC__ O '''SEND_MESSAGE''' é um comando enviado pela Aplicação CTI ao Servidor e utilizado para enviar mensagens. O servidor CTI responderá com o parâmetro '''RESP''' ...') |
(→Comando) |
||
| (Uma edição intermediária de um usuário não apresentada) | |||
| Linha 26: | Linha 26: | ||
| align="left"| INST || Instancia/Chave do comando enviado. Será retornado a mesma chave na resposta do comando. | | align="left"| INST || Instancia/Chave do comando enviado. Será retornado a mesma chave na resposta do comando. | ||
* Exemplo: INST:9e18e45af865 | * Exemplo: INST:9e18e45af865 | ||
| − | * Exmplo acima: | + | * Exmplo acima: ''SEND_MESSAGE ID:118733 RESP:OK '''INST:1234''''' |
|- | |- | ||
| align="left"| TYPE || Tipo de mensagem. | | align="left"| TYPE || Tipo de mensagem. | ||
| Linha 36: | Linha 36: | ||
* Exemplo: '''+55489XXXXXX''' | * Exemplo: '''+55489XXXXXX''' | ||
|- | |- | ||
| − | | align="left"| MESSAGE || Texto da mensagem. Deve ser no formato | + | | align="left"| MESSAGE || Texto da mensagem. Deve ser no formato [https://en.wikipedia.org/wiki/Percent-encoding '''Percent Encoding / urlencode''']. |
Exemplo: '''Bom%20dia%21''' (Bom dia!) | Exemplo: '''Bom%20dia%21''' (Bom dia!) | ||
|- | |- | ||
| Linha 49: | Linha 49: | ||
{| class="wikitable" | {| class="wikitable" | ||
| − | ! style="text-align: left; font-weight: bold;" | | + | ! style="text-align: left; font-weight: bold;" | SEND_MESSAGE TYPE:whatsapp TO:+55489XXXXXXXX MESSAGE:test TPL:FALSE ACC:+554833334840 INST:1234\r\n\r\n |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
|} | |} | ||
----- | ----- | ||
[[Protocolo_CTI_uTech#Comandos_e_Eventos|'''Volta ao menu''']] | [[Protocolo_CTI_uTech#Comandos_e_Eventos|'''Volta ao menu''']] | ||
Edição atual tal como 20h23min de 30 de maio de 2022
Tabela de conteúdo |
O SEND_MESSAGE é um comando enviado pela Aplicação CTI ao Servidor e utilizado para enviar mensagens. O servidor CTI responderá com o parâmetro RESP (OK ou ERROR). Caso a resposta seja OK, a aplicação CTI PODE acompanhar o estado da da mensagem enviada tratando os Eventos de mensagens recebidos com o Evento MESAGE como mostrado abaixo.
Após a resposta de OK do servidor, os eventos de chamadas serão encaminhados para a aplicação CTI.
>> SEND_MESSAGE TYPE:whatsapp TO:+55489XXXXXXXX MESSAGE:test TPL:FALSE ACC:+554833334840 INST:1234 << SEND_MESSAGE ID:118731 RESP:OK INST:1234 << MESSAGE DEV:2001 ID:118731 STATUS:sent << MESSAGE DEV:2001 ID:118731 STATUS:delivered
- Mensagem enviada sem a sessão de 24h do whatsapp...
>> SEND_MESSAGE TYPE:whatsapp TO:+55489XXXXXXXX MESSAGE:test RID:1234abcd TPL:FALSE ACC:+554833334840 INST:1234 << SEND_MESSAGE ID:118733 RESP:OK INST:1234 << MESSAGE DEV:2001 ID:118733 STATUS:error ERROR:1005 MESSAGE:\"Message sending failed as user is inactive for session message and template did not match\"
[editar] Parâmetros
| Parâmetros enviados para o Servidor | |
|---|---|
| INST | Instancia/Chave do comando enviado. Será retornado a mesma chave na resposta do comando.
|
| TYPE | Tipo de mensagem.
|
| TO | numero destino da mensagem. No formato E.164.
|
| MESSAGE | Texto da mensagem. Deve ser no formato Percent Encoding / urlencode.
Exemplo: Bom%20dia%21 (Bom dia!) |
| TPL | Define se a mensagem é um template. Ou seja, mensagem pré-definida no broker whatsapp (Twillio, Gupshup ou Dialog360), que pode ser enviada sem a sessão de 24h do Whatsapp.
|
| ACC | Campo que define por qual conta será enviada a mensagem. O campo, se preenchido, deve conter a número da conta de envio no formato E.164. Caso não seja enviado, o PABX uTech irá utilizar a conta padrão (Se houver uma conta padrão configurada) |
[editar] Comando
| SEND_MESSAGE TYPE:whatsapp TO:+55489XXXXXXXX MESSAGE:test TPL:FALSE ACC:+554833334840 INST:1234\r\n\r\n |
|---|
