O que é
A tela Integrações conecta a sua conta a serviços externos: meios de pagamento para o Voucher PIX, envio de SMS e de e-mail, WhatsApp, CRM, webhooks e logins por sistemas de provedor, LDAP ou hotel. Cada cartão mostra o nome do serviço, uma descrição e o status: Ativa, Inativa ou Não Configurada.
Onde fica
No menu lateral, clique em Configurações e depois em Integrações. A lista mostra só as integrações que a plataforma disponibiliza para a sua conta.
Passo a passo
- Encontre o serviço pela busca (Buscar integrações...) ou pelo filtro de tipo.
- Clique em Configurar (ou Editar, se já estiver configurada).
- Preencha os campos. Os obrigatórios têm *. Campos de cópia, como a URL do webhook, têm o botão Copiar para área de transferência.
- Em Status da Integração, deixe a integração ativa. Desativada, ela não é usada pelo sistema.
- Clique em Salvar Configuração (ou Atualizar Configuração).
- Quando a tela oferecer, clique em Testar Configuração. O teste existe para SMS, e-mail, logins de provedor e LDAP e Mercado Pago QR.
O que cada tipo pede
Pagamento (Voucher PIX)
Os meios de pagamento disponíveis são Mercado Pago, Mercado Pago QR Code, EFI (Gerencianet) e Asaas. Todos pedem as credenciais da sua conta no gateway e têm o campo Modo Sandbox, para testes. Os que dependem de aviso de pagamento mostram a URL do webhook para você cadastrar no gateway. Veja o passo a passo da EFI em Como Configurar GerenciaNet EFI para Receber no PIX.
Deixe só um meio de pagamento ativo. Com dois ou mais, a tela avisa e as cobranças saem por apenas um deles.
SMS
Pede os dados do seu contrato com a operadora de SMS (usuário e senha ou chave de API, URL da API e número de envio) e as opções de uso: Usar para avisos de voucher, Usar para pedidos do cardapio, Usar para recuperacao de senha e Usar para validacao de telefone. O teste envia um SMS real e consome crédito.
SMTP Próprio pede Servidor SMTP, Porta (587 para TLS, 465 para SSL), Criptografia, Usuario, Senha, Email remetente e, opcional, Nome do remetente. Em contas Google, use uma senha de aplicativo.
O WhatsApp é um serviço gerenciado pela plataforma, contratado como adicional: não há credencial para preencher, basta conectar o seu número. Veja WhatsApp: contratar e conectar.
CRM e Webhook
O CRM pede os tokens e o identificador de conversão da sua conta. O Webhook Genérico pede a URL do Webhook, o Método HTTP (POST, PUT ou PATCH), cabeçalhos opcionais e o Timeout (segundos).
Logins por provedor, LDAP e hotel
Cada um tem artigo próprio:
Dicas e observações
- Para trocar de gateway, desative o antigo antes de ativar o novo.
- Remover apaga a configuração. Para pausar, basta desativar.
Problemas comuns
| Sintoma | O que fazer |
|---|---|
| "Salve antes de testar" | Clique em Salvar Configuração e depois em Testar Configuração. |
| O serviço que procuro não aparece | Ele não está disponível para a sua conta. Fale com o suporte. |
| Pagamento aprovado, mas o voucher não é liberado | Confira se a URL do webhook foi cadastrada no gateway e se a integração está ativa. |