Integrador Webhook - Assinante de Campanha - Status Alterado para Erro

Owned by Iuri Diniz (Unlicensed)
Last updated: Sept 26, 2023 by Lucas Castro
3 min read

Esse recurso oferece a possibilidade de integrar o Evolux à outras plataformas, permitindo o envio de informações ed quando um assinante foi marcado como Erro.

Para acessa-lo, basta ir em APLICATIVOS > MARKETPLACE, selecione a opção do Integrador Webhook Genérico

O ambiente de Marketplace vem desabilitado por padrão, para ter acesso ao mesmo, favor contactar o Suporte Evolux.

Quando um assinante é marcado como erro?

Existe vários momentos para isso acontecer.

Na versão 7.28.0, os seguintes momentos disparam esse webhook

Quando o assinante é marcado como número inválido por um operador.

Quando o número de tentativas para um assinante excede o Contagem de Tentativas configurado para a campanha.

Note que não há um garantia forte de que o Intervalo Entre Tentativas configurado será de fato respeitado, podendo haver divergências entre os intervalos. Se há necessidade de que o intervalo seja estritamente obedecido, entre em contato com o suporte.

Quando o número cadastrado para o assinante é inválido ou a campanha não tem permissão para discar para esse número.

Para resolver esse erro, verifique as regras da campanha e/ou o número cadastrado para o assinante.

Crie e Configure seu Webhook

 

  1. Escolha o evento que vc quer acompanhar: campaign_subscriber::marked_as_error

  2. Selecione o método HTTP: POST , GET, PUT, DELETE

  3. Insira a URL que vai ser chamada.

  4. Insira os dados que serão postados nesta URL

    1. Veja tabela a seguir para saber as possível variáveis

    2. Seguem dados usados nesse teste:

      { "id evolux": "{{subscriber.id}}", "id externo": "{{subscriber.external_id}}", "nome": "{{subscriber.name}}", "primeiro numero": "{{subscriber.numbers[0]}}", "campos personalizados - CPF": "{{subscriber.custom_fields['cpf']}}", "status": "{{subscriber.status}}", "id da campanha": "{{campaign.id}}", "nome da campanha": "{{campaign.name}}" }

  5. Clique em Criar

Exemplo de uma chamada POSTpara o webhook criado acima

POST /callme HTTP/1.1 Host: ex.com Accept-Encoding: gzip, deflate Accept: */* Connection: keep-alive Content-Type: application/json { "id evolux":"37", "id externo":"", "nome":"Mariana Reis", "primeiro numero":"8499991234", "campos personalizados - CPF":"12312312399", "status":"Error", "id da campanha":"1", "nome da campanha":"campanha de venda de panetones" }

Variáveis

O corpo de request é totalmente personalizável, para usar uma variável utilize {{nome da variável}}

As possíveis variáveis para serem utilizadas são:

Nome

Descrição

Exemplos de valores

Nome

Descrição

Exemplos de valores

{{subscriber.id}}

ID do assinante no Evolux

"1"

{{subscriber.external_id}}

ID externo cadastrado para este assinante

"9999"

"ext123"

{{subscriber.name}}

Nome do assinante

"Elis Regina"

{{subscriber.numbers[INTEIRO]}}

 

Array de todos o números do assinante. Deve ser acessado pelo índice do elemento.

Acessando o número na posição 0: {{subscriber.number[0]}}

"8499991234"

{{subscriber.status}}

Estado do assinante, para campaign_subscriber::marked_as_errordeve ser sempre "Error"

"Error"

{{subscriber.custom_fields['NOME_DO_CAMPO']}}

 

Array associativo dos campos customizados cadastrados para esse assinante.

Deve ser acessado pelo índice do elemento.

Acessando o campo customizado de nome cpf: {{subscriber.custom_fields['cpf']}}

"12312312399"

{{campaign.name}}

Nome da campanha.

"Venda de Senhas"

{{campaign.id}}

ID da campanha no Evolux.

"1"