solar.ia

API SOLAR.IA

Comece a integrar

A API do SOLAR.IA conecta seu ERP, site, CRM ou automação ao atendimento pelo WhatsApp: crie contatos, envie mensagens e modelos, mova conversas, inicie chatbots e receba eventos em tempo real.

Endereço basehttps://api.seudominio.com.br/integrations/v1AutenticaçãoAuthorization: Bearer sk_... em todas as chamadasFormatoJSON (UTF-8), com respostas em JSON

Primeira chamada em 3 passos#

  1. 1

    Gere um token

    No painel, abra Ajustes › Integrações › Integração via API e clique em Novo. Só administradores do workspace criam tokens. Copie na hora: por segurança, ele não aparece de novo.

  2. 2

    Teste a conexão

    curl https://api.seudominio.com.br/integrations/v1/me \
  --header 'Authorization: Bearer sk_SEU_TOKEN'

    A resposta traz o workspace dono do token. Veja Testar conexão.

  3. 3

    Envie a primeira mensagem

    curl --request POST https://api.seudominio.com.br/integrations/v1/messages \
  --header 'Authorization: Bearer sk_SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{ "phone_number": "11999990000", "name": "Maria", "content": "Olá! Tudo certo com seu pedido." }'

    Se o contato não existir, ele é criado; se não houver conversa, uma é aberta no primeiro canal conectado. Detalhes em Enviar mensagem.

O que dá para fazer#

ContaTeste o token e veja o workspace.1 endpointCanaisNúmeros de WhatsApp conectados.1 endpointContatosBusque, crie e atualize contatos.8 endpointsEtiquetasMarque contatos e dispare automações.3 endpointsMensagensEnvie textos e modelos aprovados.1 endpointModelosModelos de mensagem do workspace.1 endpointConversasListe e resolva atendimentos.2 endpointsSequênciasInscreva contatos em cadências.2 endpointsChatbotsInicie fluxos de automação.3 endpointsWebhooksReceba eventos em tempo real.3 endpoints

Receber eventos#

Para saber quando chega uma mensagem, uma conversa é resolvida ou um contato muda, cadastre um webhook: o SOLAR.IA faz um POST assinado no seu endereço a cada evento. Usa n8n? O nó oficial já faz tudo isso sem código.

Próximo Autenticação