Smart Processes (SPA) no WASync

Os Smart Processes do Bitrix24 (SPA, "smart process automation") são entidades personalizadas do CRM ao lado de leads e negócios: contratos, solicitações de serviço, reservas, reclamações. O WASync trata um item de SPA como um lead ou um negócio sempre que isso faz sentido:

• a aba WASync no cartão do item mostra a conversa de WhatsApp do cliente do item;
• uma conversa no WASync Chat pode ser vinculada a um item, e o responsável do item conta para o filtro "Atribuído a" e para o escopo "somente meus registros";
• as mensagens são gravadas na linha do tempo do item (comentários), como em leads e negócios;
• os robôs do WASync (enviar mensagem, enviar modelo, iniciar um Chat Flow, IA) rodam a partir das regras de automação do processo, e um Chat Flow pode ler e preencher os campos do item.

O que o item precisa

Um item de SPA não tem número de telefone próprio. O WASync chega até a pessoa pelo cliente vinculado ao item: o contato (ou a empresa) no campo Cliente do item. Esse campo só existe quando o processo foi criado com Cliente ativado (CRM → Smart Processes → o processo → Configurações → Cliente).

• Processo sem Cliente: a aba WASync explica que não há ninguém para quem escrever e leva ao cartão do item. Ative Cliente nas configurações do processo e depois vincule um contato ao item.
• Item com um contato sem telefone: a aba oferece adicionar o número, como em um negócio.
• Vários contatos em um item: o WASync usa primeiro o contato principal, depois os outros na ordem do item, e por fim o telefone da empresa.

A aba WASync no cartão do item

Abra qualquer item do processo. A aba WASync funciona como a dos negócios: a conversa com o cliente, envio de texto, arquivos, mensagens de voz e (no plano da API oficial) modelos. O cabeçalho mostra o título, a etapa e o responsável do item.

A aba é adicionada automaticamente:

• na instalação, para todos os processos que existem naquele momento;
• quando um processo é criado ou alterado depois (o WASync escuta os eventos de processo do Bitrix24), e uma vez por dia como garantia;
• imediatamente, se um administrador abrir WASync → Configurações → Reinstalar placements.

Se um processo recém-criado ainda não mostrar a aba, recarregue a página um minuto depois ou use Reinstalar placements.

Vincular uma conversa a um item

No WASync Chat, abra a conversa → Vincular ao registro. Quando o portal tem Smart Processes, aparece um seletor de tipo acima da busca: escolha o processo, digite pelo menos duas letras do título do item e selecione o item. A linha da caixa de entrada passa a mostrar o nome do processo como chip do registro, o cabeçalho mostra o responsável e a etapa do item, e Alterar registro permite mover a conversa para outro item.

As permissões do Bitrix24 se aplicam: a busca roda como o operador, então só são oferecidos os itens que essa pessoa pode ver.

Linha do tempo

Com a configuração padrão da linha do tempo, cada mensagem é gravada como comentário nos registros que têm o telefone do cliente — leads, negócios, contatos, empresas — e no item vinculado. Com Destino da linha do tempo → registro da conversa, as mensagens são gravadas uma única vez, no registro ao qual a conversa está vinculada, que pode ser um item de SPA.

Robôs nas regras de automação

Abra o processo → Regras de automação. Os robôs do WASync aparecem no grupo WASync, exatamente como em leads e negócios:

• Enviar mensagem de WhatsApp / Enviar modelo de WhatsApp (WABA): o destinatário é o cliente do item (contato principal, outros contatos, empresa, nessa ordem). Os {{Fields}} do item, do contato e da empresa estão disponíveis no texto.
• Iniciar um Chat Flow: inicia um fluxo cujo tipo de registro é este processo (veja abaixo).
• Robô de IA: como em negócios.

Depois de instalar ou atualizar o WASync, recarregue a página de automação uma vez: o Bitrix24 mantém as definições dos robôs em cache até a página ser recarregada.

Chat Flows em um processo

No editor do Chat Flows, o seletor Registro lista todos os processos que têm automação ativada. Um fluxo criado para um processo:

• inicia somente a partir de uma regra de automação desse processo (o robô Iniciar um Chat Flow); os gatilhos de "primeira mensagem" e "palavra-chave" não são oferecidos, porque uma mensagem de um número novo não consegue criar um item sozinha;
• pode ler e preencher os campos do item (Preencher um campo, Inserir campo), inclusive campos personalizados, e os campos do contato e da empresa do item;
• pode mover o item com Definir etapa → Mover item: escolha o funil (quando o processo tem vários) e a etapa;
• pode atribuir o item, criar uma atividade nele e transferir a conversa, como em um negócio.

{{record.stage}} mostra o nome da etapa, {{record.title}} o título do item.

Atribuição de anúncios (Click-to-WhatsApp)

Quando uma conversa que começou em um anúncio Click-to-WhatsApp é vinculada a um item, o WASync preenche os campos UTM nativos do item (source, medium, campaign, content, term) se ainda estiverem vazios, e deixa um comentário na linha do tempo com o anúncio. Os campos personalizados UF_CRM_CTWA_* não são criados em Smart Processes: o Bitrix24 não permite que um aplicativo adicione campos de usuário ali.

Limites nesta versão

• As Automações v2 (envios acionados por eventos) e o robô Enviar conversão para a Meta continuam apenas em leads e negócios.
• Um fluxo não consegue criar um item de SPA a partir de uma conversa nova; vincule a conversa a um item ou inicie o fluxo pela automação do processo.
• Os anexos De um campo do CRM nos Chat Flows leem apenas campos de arquivo de leads e negócios.
• As chamadas iniciadas a partir do cartão do item ainda não estão ligadas ao item.

REST e MCP

Nada muda na Platform API: os itens são os objetos crm.item.* do próprio Bitrix24. Nos dados do WASync, um item vinculado aparece com o tipo de registro dynamic_<entityTypeId> (por exemplo, dynamic_137), onde os leads aparecem como lead e os negócios como deal.