Conta e integrações

Conectar um sistema externo ou assistente

Crie uma chave restrita no Pro ou Agency, publique conteúdo atualizado ou conecte um assistente.

Antes de começar

Um webhook recebe avisos de mensagens recebidas do serviço de WhatsApp. A configuração no servidor cabe ao responsável pela integração. Usuários do painel não precisam alterar o servidor. MCP permite a um assistente solicitar ferramentas da conta.

O que fazer

Para mensagens recebidas, abra Configurações e localize a URL do Webhook.
Escolha Copiar para obter o endereço exato da instalação da sua conta.
Peça ao responsável que configure os eventos recebidos do dispositivo desejado com esse endereço.
Combine uma mensagem de teste recebida de um número seu quando o responsável confirmar a configuração.
Confira o resultado esperado, como uma resposta automática correspondente ou uma nova mensagem de grupo registrada quando Log está ativado.
Para conectar um assistente, entre na conta pela tela de autorização aberta pelo aplicativo que usa MCP.
Confira o nome do aplicativo e a conta antes de aprovar o acesso.
Para integrar envios, abra Configurações → Integrações externas. Crie uma chave com nome para uma conta conectada e grupos selecionados explicitamente. Salve a chave na hora; ela aparece apenas uma vez. Copie a URL base da API.
Exemplo: Configure o Abacus.AI para gerar conteúdo atualizado em cada um dos oito horários diários de publicação em America/Sao_Paulo. Envie cada publicação aos três grupos permitidos com um novo Idempotency-Key. Reutilize a chave apenas ao repetir a solicitação idêntica.
Omita scheduled_at para entrar na fila imediatamente ou informe data e hora absolutas com -03:00 ou Z (UTC), até 30 dias à frente. O processador verifica a fila a cada minuto; scheduled_at é o primeiro horário permitido, sem garantia de envio no segundo exato.
Consulte o estado e o resultado por grupo antes de repetir. Cancele apenas envios ainda não iniciados. Revogue uma chave comprometida nas Configurações, depois crie e salve outra; publicações antigas não são retomadas com uma nova chave.

Exemplo completo

Solicitações com placeholders; substitua os IDs e escolha uma data futura antes de enviar. Estas solicitações publicam mensagens reais. curl '<API_BASE_URL>/v1/groups' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-0900' -H 'Content-Type: application/json' --data '{"type":"text","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"text":"Updated publication","scheduled_at":"2026-10-16T09:00:00-03:00"}' curl -X POST '<API_BASE_URL>/v1/jobs' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' -H 'Idempotency-Key: publication-2026-10-16-1200' -F 'payload={"type":"image","group_ids":["<GROUP_JID_1>","<GROUP_JID_2>","<GROUP_JID_3>"],"caption":"Updated caption"}' -F 'image=@publication.png;type=image/png' curl '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>' curl -X DELETE '<API_BASE_URL>/v1/jobs/<JOB_ID>' -H 'Authorization: Bearer <ZAPBOT_API_KEY>'

Como conferir se funcionou

A aceitação da publicação e os resultados aceitos por grupo confirmam a aceitação pelo serviço. Não confirmam entrega ou leitura. Envios agendados podem ser bloqueados se o acesso, a chave, a conta ou as permissões dos grupos mudarem.

O que você precisa saber

Assistentes podem consultar os registros disponíveis e enviar texto quando solicitado. Consulte o guia das ferramentas do assistente antes de pedir um envio.
Use o painel para ações de edição indisponíveis por MCP.
O acesso à API está incluído nos planos Pro e Agency mensais ou anuais. Starter exige mudança de plano. A chave permite apenas a conta e os grupos selecionados; substituir a conta do WhatsApp bloqueia o envio. Nunca compartilhe credenciais do servidor.
Textos aceitam 4.096 caracteres; legendas, 1.024. Envie JPEG, PNG ou WebP de até 5 MiB nos campos multipart payload e image. URLs remotas de imagem não são aceitas.
Uma nova publicação retorna HTTP 202. Repetir o mesmo conteúdo com Idempotency-Key idêntico retorna a publicação original com HTTP 200; conteúdo diferente com a mesma chave retorna 409. Um timeout após iniciar o envio pode ficar não confirmado; não reenvie automaticamente com outra chave.

Problemas comuns

O que aparece: Não aparece resposta nem novo registro após o teste.
O que fazer: Confira a conexão do dispositivo e a regra ou o controle Log correspondente, depois peça ao responsável que verifique a configuração dos eventos recebidos.
O que esperar: Um recurso configurado corretamente pode processar um novo evento correspondente.

O que aparece: O assistente não autoriza ou mostra outra conta.
O que fazer: Volte ao login e selecione a conta desejada; informe erros repetidos de autorização ao responsável pela integração.
O que esperar: A tela de autorização e os registros retornados pertencem à conta desejada.

Mais ajuda

Informe ao responsável o recurso e o erro visível. Não inclua credenciais do servidor em conversas com assistentes.

Abrir este recurso