Na Talkey você pode criar mapeamentos personalizados para receber payloads com estruturas diferentes do padrão! Nesse tutorial, vamos mostrar como criar, configurar e gerenciar mapeamentos de payloads personalizados no seu canal. Isso é útil quando um sistema externo envia dados em um formato próprio e você precisa adaptá-los para a Talkey.
- Na página de detalhes do canal no painel administrativo https://app.talkey.ai, acesse a aba Webhooks.
2. Na seção Mapeamento de Payloads Personalizados, clique no botão + Novo Mapeamento.
3. No modal de criação, você verá dois painéis:
- Painel esquerdo: lista de variáveis disponíveis que você pode usar no mapeamento. Cada variável possui um indicador de obrigatoriedade:
- Indicador vermelho: sempre obrigatório (ex: Nome do cliente)
- Indicador laranja: obrigatório pelo menos um (Telefone OU E-mail)
- Indicador azul: obrigatório pelo menos um (Texto OU Mídia OU Template)
- Sem indicador: opcional (ex: Legenda da mídia, Args do template)
- Painel direito: editor JSON onde você monta o mapeamento. Clique em uma variável no painel esquerdo para inseri-la no editor.
Exemplo de mapeamento:
{
“client_name”: “{{customer.name}}”,
“contact_phone”: “{{customer.cell_phone}}”,
“message_content”: “{{message.text}}”
}
4. Abaixo do editor, configure as opções adicionais do mapeamento:
Desativar IA: ative esta opção para que a IA não responda automaticamente às mensagens recebidas por este mapeamento.
Receber mensagem como: escolha se as mensagens recebidas por este mapeamento serão tratadas como Cliente ou Usuário.
5. Após salvar, o mapeamento aparecerá na lista com sua URL exclusiva (gerada automaticamente com token próprio). O sistema externo deverá enviar o payload para essa URL no formato que você configurou.
6. Para cada mapeamento criado, você pode:
- Excluir (ícone de lixeira): para remover o mapeamento permanentemente.
- Copiar a URL (ícone de cópia): para compartilhar com o sistema externo.
- Editar (ícone de lápis): para modificar o mapeamento, alterar configurações ou ativar/desativar.
Obs: Ao editar um mapeamento, você também pode alterar o status entre ativo e inativo sem precisar excluí-lo.
Conclusão
Com os mapeamentos de payloads personalizados, você consegue adaptar qualquer integração externa ao seu canal da Talkey! Cada mapeamento gera uma URL exclusiva, permitindo que diferentes sistemas enviem dados em seus próprios formatos sem precisar alterar o payload de origem.
