Canal personalizado: mapeamento de campos
Use o mapeamento de campos para que o Omnifox entenda o JSON do seu sistema sem alterá-lo. Vale apenas para mensagens de entrada.
O mapeamento de campos do canal personalizado serve para quando o seu sistema não consegue enviar as mensagens no formato padrão do Omnifox. Em vez de alterar o seu sistema, você indica ao Omnifox em que parte do seu JSON está cada dado.
Nota: o mapeamento é somente de entrada (mensagens que chegam do seu sistema). O que o Omnifox envia para a sua URL de saída tem sempre o mesmo formato, descrito no Guia técnico de integração: o seu sistema precisa se adaptar a ele.
Quando você precisa dele
- Não precisa se o seu sistema já envia
contact.id,text,ide, quando for o caso,mediaouattachmentscom esses nomes. - Precisa se o seu sistema já gera um JSON próprio que você não pode mudar, por exemplo
{"data":{"user":{"uid":"..."}}}.
Como configurar
- Abra o canal em Canais e edite-o (ou configure ao criá-lo).
- Em Mapeamento de campos, clique em Adicionar.
- À esquerda, escreva o caminho do dado no seu JSON, com pontos:
data.user.id. Para listas, use o número da posição:items.0.url. Você pode começar o caminho com$.se preferir. - À direita, escolha o campo do Omnifox que esse dado preenche.
- Repita para cada dado e clique em Continuar para salvar.
Campos do Omnifox disponíveis
| Campo do Omnifox | Para que serve |
|---|---|
| ID do contato (obrigatório) | O ID do usuário no seu sistema. Se não chegar direto nem mapeado, a mensagem é recusada. |
| Nome, telefone, e-mail e URL da foto do contato | Dados do contato. |
| Texto da mensagem | O texto. |
| Tipo de mensagem | text, image, video, audio ou file. |
| ID da mensagem (deduplicação) | Evita duplicados se o seu sistema reenviar a mesma mensagem. |
| URL, legenda, tipo MIME e nome do arquivo de mídia | Um anexo. Se você mapear algum deles, a lista attachments da mensagem é ignorada. |
| Lista de anexos | Uma lista completa de anexos. |
| Equipe (id ou nome) e Agente (id ou e-mail) | Para quem vai uma conversa nova ou sem atribuição. |
| Campo personalizado: nome | Aparece um para cada campo personalizado de contato criado no seu espaço de trabalho. |
Regras
- O que você mapeia tem prioridade sobre um campo com o nome padrão.
- Se o caminho não existir em uma mensagem específica, essa linha simplesmente não faz nada.
- A assinatura da mensagem é sempre verificada sobre o seu JSON original; o mapeamento é aplicado depois.
- Os caminhos são simples: não aceitam curingas, filtros nem transformações.
Exemplo
Seu sistema envia:
{"data":{"user":{"uid":"user-M","nombre":"Mario"},"msg":{"mid":"m-1","cuerpo":"Olá","foto":"https://cdn.example.com/a.jpg"}}}
Com estas linhas:
| Caminho no seu JSON | Campo do Omnifox |
|---|---|
data.user.uid |
ID do contato |
data.user.nombre |
Nome do contato |
data.msg.cuerpo |
Texto da mensagem |
data.msg.mid |
ID da mensagem |
data.msg.foto |
URL da mídia |
O Omnifox cria o contato user-M com o nome "Mario" e uma mensagem de imagem com a legenda "Olá".
Problemas frequentes
- Erro de
contact.idobrigatório: o caminho do ID do contato não corresponde ao seu JSON. Confira maiúsculas, pontos e níveis. - A mensagem chega sem texto ou sem imagem: o caminho desse dado está escrito errado ou aponta para outro nível.
- Meu sistema espera outro formato nas respostas: não existe mapeamento de saída; adapte o seu receptor ao formato fixo do Omnifox.
Artigos relacionados
Artigos relacionados
-
Códigos de erro do WhatsApp (Meta): o que significam e o que fazer
Tabela com os códigos de erro da Meta mais comuns ao enviar pelo WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) e como resolver cada um.
-
Como conectar o Telegram
Conecte um bot do Telegram à sua caixa de entrada do Omnifox em minutos usando o BotFather.
-
Comentários do Instagram e do Facebook: responder e moderar pelo Omnifox
Veja e responda os comentários das suas publicações e anúncios do Facebook e do Instagram, em público ou no privado, e configure respostas automáticas.
-
Enviar e receber vídeos em cada canal: formatos e tamanhos máximos
Quais vídeos você pode enviar e receber pelo WhatsApp, Instagram, Messenger, Telegram, chat do site e e-mail, com os tamanhos máximos reais e o que fazer com um vídeo pesado.
-
Conectar o WhatsApp escaneando um código QR
Vincule seu WhatsApp ao Omnifox em um minuto, como no WhatsApp Web. Ideal para testar: tem limites, não permite campanhas e não é a API oficial.