Os métodos da API de Fontes permitem que uma integração gerencie suas próprias fontes. A integração pode ser identificada verificando o Token de Acesso usado ao adicionar cada fonte.

Cada fonte tem um código único (external_id).

Uma integração pode adicionar até 100 fontes.

A API de Fontes também permite que a integração crie leads recebidos e escolha o pipeline no qual eles serão criados.

Uma vez criadas, as fontes aparecerão em vários locais, como:

o campo de fonte do lead recebido criado via API de bate-papo
o campo de canais para a opção Mensagem ao configurar um bot

a lista de opções de contato quando a funcionalidade Escrever Primeiro estiver ativada

a aba Estatísticas do cartão do lead criado usando uma das fontes

Além disso, é possível especificar a fonte ao criar um lead via API usando os métodos adicionar lead ou adição complexa de lead enviando o objeto _embedded[source] com o ID da fonte no external_id e o tipo de fonte sempre definido como "widget".

"source":
        {
           "external_id": "ufi7pscriq7foaaz2afxakxtuf2yytuh7vjg1pxr",
           "type": "widget"
        }

Uma integração, usando a API de Fontes, pode adicionar opções para selecionar números de WhatsApp, que são usados ao configurar um botão em um site Plugin de CRM.

A fonte pode ser especificada com a propriedade waba se a integração funcionar com o WhatsApp oficial e uma janela de tempo estiver configurada. O parâmetro permite gerenciar modelos de WhatsApp e usá-los na nova etapa “Enviar Mensagem” no Salesbot. Após especificar esse parâmetro, você deve se inscrever nos eventos de envio de um modelo para aprovação. Ao receber um evento, a integração pode transferir o modelo para aprovação no WhatsApp e, dependendo do resultado, alterar o status do modelo via API.

Requisitos de Integração para Trabalhar com a API de Fontes

A seção de configurações do Digital Pipeline exibe as fontes geradas pela integração.

Antes de trabalhar com a API de Fontes, certifique-se de que a integração atenda aos seguintes critérios:

A integração possui um widget com seu arquivo manifest.json, especificando a capacidade de exibir o widget na interface para adicionar uma nova fonte "locations": ["lead_sources"].
Para integrações que funcionam com bate-papos, o código do widget e o ID da integração devem ser especificados no canal de bate-papo ao registrá-lo.

Ao criar uma nova integração, você pode optar por ativar a função Múltiplas Fontes. Essa opção deve ser ativada quando a integração gerencia completamente as fontes por meio da API em seu backend, e a criação da fonte pelo lado do Kommo não é mais necessária. Se a opção não estiver ativada, a fonte será criada no lado do Kommo quando a integração for instalada.