> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Configurar a integração com a Phonexa
> Saiba como conectar a Phonexa ao LanderLab para enviar leads diretamente para suas campanhas da Phonexa em tempo real a partir de qualquer landing page ou funil de quiz.
> Conecte a Phonexa às suas landing pages no LanderLab para enviar dados de leads diretamente para as suas campanhas da Phonexa em tempo real. Tudo o que você precisa são as suas credenciais da Publisher API da plataforma Phonexa.
## O que é a Phonexa?
A Phonexa é uma plataforma completa de marketing de performance usada por geradores de leads, publishers e anunciantes para gerenciar distribuição de leads, rastreamento de chamadas, e-mail marketing e muito mais. O produto LMS Sync cuida do envio de leads, permitindo que os publishers enviem leads por HTTP POST para as campanhas da Phonexa em tempo real.
Quando você conecta a Phonexa à sua landing page no LanderLab, cada lead coletado é enviado automaticamente para a sua campanha da Phonexa usando as suas credenciais da Publisher API. O LanderLab cuida da conexão com a API para você, então não é preciso escrever código personalizado nem criar integrações no servidor manualmente.
As integrações com a Phonexa **não** são salvas globalmente. Cada integração é configurada por landing page, então você precisará configurar uma nova conexão com a Phonexa para cada landing page da qual quiser enviar leads.
***
## Como adicionar a Phonexa
A configuração da Phonexa usa um assistente de 3 passos: configure a conexão, mapeie seus campos e revise o payload final antes de conectar.
### Passo 1: Configurar a conexão
Vá até **Landing Pages** e clique no **nome da landing page** à qual você quer adicionar a integração com a Phonexa.
Clique em **Add Integration** para abrir o painel de integrações.
Na lista de integrações disponíveis, encontre **Phonexa integration** (com a descrição "Send leads to Phonexa in real time") e clique nela. O assistente de configuração será aberto.
Informe os seguintes dados:
| Campo | Descrição |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name** | Um nome para identificar esta integração (ex.: "Phonexa - Financiamento de veículos"). Isso ajuda você a reconhecê-la na lista de integrações. |
| **API URL** | A URL do endpoint de envio do seu produto na Phonexa (ex.: `api.phonexa.com/...`). Ela é informada nas especificações da Publisher API da Phonexa. |
| **API ID** | O seu Publisher API ID numérico (ex.: `12345`). É o identificador exclusivo atribuído à sua conta de publisher na Phonexa. |
| **API Password** | A senha de API associada ao seu Publisher API ID. Ela é definida e gerenciada dentro da Phonexa. |
Para encontrar a sua **API URL**, o **API ID** e a **API Password**, faça login na sua conta da Phonexa, acesse **LMS Sync** e abra **Publisher Products API**. Selecione o produto para o qual você quer enviar leads. A URL de envio, o API ID e a API Password estão listados na seção Lead Specs da sua documentação da API. Você também pode encontrá-los no seu perfil de publisher, nas configurações de API Access.
Clique em **Continue** para avançar para o passo de mapeamento de campos.
***
### Passo 2: Mapear seus campos
Neste passo, você escolhe quais campos de dados incluir na requisição e como eles devem ser nomeados ao serem enviados para a Phonexa.
O LanderLab inclui automaticamente um conjunto de campos padrão do LanderLab. Cada campo tem uma caixa de seleção para incluí-lo ou excluí-lo e uma coluna **Sent As**, na qual você pode renomear a chave para que ela corresponda ao que a Phonexa espera.
Os campos padrão do LanderLab são:
| Campo do formulário | Sent As (chave padrão) | Descrição |
| :------------------------- | :----------------------- | :-------------------------------------------------------- |
| **LL Lander URL** | `ll_lander_url` | A URL completa da landing page em que o visitante estava. |
| **LL Visitor IP** | `ll_visitor_ip` | O endereço IP do visitante. |
| **LL Visitor User Agent** | `ll_visitor_user_agent` | As informações de navegador e dispositivo do visitante. |
| **LL Submission Time UTC** | `ll_submission_time_utc` | A data e a hora em que o lead foi enviado (em UTC). |
| **LL Variant ID** | `ll_variant_id` | O ID da variante do teste A/B exibida ao visitante. |
Use as caixas de seleção para ativar ou desativar qualquer campo. Edite o valor de **Sent As** para que ele corresponda aos nomes de campo das especificações da API da Phonexa.
Se a sua landing page tiver um **funil de quiz** ou um **formulário**, todos os campos de formulário que você adicionou (como nome, e-mail, telefone, endereço e quaisquer campos personalizados) aparecerão automaticamente nesta lista, junto com os campos padrão do LanderLab. Você pode ativá-los, desativá-los ou renomeá-los da mesma forma que os campos padrão. Certifique-se de que os valores de **Sent As** correspondam exatamente aos nomes de campo das especificações da API da Phonexa. A Phonexa rejeita leads que incluam campos no formato errado ou sem valores obrigatórios.
Na seção **Additional fields**, clique em **+ Add field** para incluir pares de chave-valor extras na requisição. Isso é útil para enviar valores fixos, como sub IDs, identificadores de origem do tráfego ou qualquer parâmetro personalizado que a sua campanha da Phonexa exija.
Clique em **Continue** para avançar para o passo de revisão.
***
### Passo 3: Revisar e conectar
O último passo mostra um resumo completo do que será enviado à Phonexa para cada lead. Você verá:
* O **tipo de envio** e o nome da integração
* A seção de **configuração**, com a sua API URL, o API ID e a API Password
* A seção de **mapeamento de campos**, com todos os campos e as variáveis de modelo correspondentes (ex.: `{{LL Lander URL}}`, `{{LL Visitor IP}}`)
Revise tudo com atenção para garantir que a configuração e os nomes dos campos correspondam ao que a sua campanha da Phonexa espera. Se algo parecer errado, clique em **Back** para voltar aos passos anteriores.
Se estiver tudo certo, clique no botão **Connect Phonexa** para salvar e ativar a integração.
***
## Onde encontrar suas credenciais da API da Phonexa
Se você não tiver certeza de onde encontrar a sua API URL, o API ID e a API Password, siga estes passos:
1. Faça login na sua conta da [Phonexa](https://app.phonexa.com).
2. Acesse **LMS Sync** na barra lateral esquerda.
3. Clique em **Publisher Products API**.
4. Selecione o produto ao qual você quer se conectar.
5. Na seção **Lead Specs**, você encontrará a **posting URL** (a sua API URL), o **API ID** e a **API Password**.
Você também pode encontrar o seu API ID e a API Password no seu perfil de publisher, nas configurações de **API Access**. Clique no botão **Show** ao lado do campo API Password para revelar o valor.
Se você alterar ou redefinir a sua API Password dentro da Phonexa, a senha antiga deixará de funcionar. Não se esqueça de atualizar a senha no LanderLab se você redefini-la.
***
## Dicas para a integração com a Phonexa
* **Use exatamente os mesmos nomes de campo** - A Phonexa valida todos os campos recebidos com base nas especificações da API do seu produto. Use a coluna **Sent As** no Passo 2 para renomear os campos de forma que correspondam exatamente aos nomes de campo da sua documentação da Phonexa.
* **Verifique os campos obrigatórios** - As especificações da API do seu produto na Phonexa indicam claramente quais campos são obrigatórios. Leads sem os campos obrigatórios ou com valores no formato errado serão rejeitados.
* **Use o modo de teste durante a configuração** - A Phonexa oferece um modo de teste, ativado ao adicionar `testMode=1` ao payload. Você pode usar a seção **Additional fields** no Passo 2 para adicionar isso como um par de chave-valor fixo durante os testes. Remova-o antes de colocar a integração no ar.