Pular para o conteúdo principal

Visão geral

O Joinotify Cloud é uma provedora de tecnologia homologada pela Meta. Nós mantemos a integração com a Meta Cloud API e expomos ela para você através da nossa infraestrutura — você conecta um número, recebe um token e começa a enviar.

O que normalmente atrasa um projeto de WhatsApp oficial some do caminho:

  • Sem Business Manager verificada. A verificação de negócio é nossa, não sua.
  • Sem App Review. Você não cria nem submete um aplicativo na Meta.
  • Sem infraestrutura. Nada de webhook próprio na Meta, System User ou token de longa duração para gerenciar.
  • Sem exposição de credenciais. Seu token do Joinotify substitui o token da Meta; a credencial real nunca sai da nossa infraestrutura.

As duas formas de usar​

A API oferece duas superfícies sobre a mesma base. Você pode misturar as duas no mesmo projeto, com o mesmo token.

API simplificada​

Um endpoint de envio, com o payload reduzido ao essencial: o tipo vai no corpo e o número de origem é resolvido a partir do seu token. Cobre texto e template — que são a maior parte do volume de qualquer integração.

POST api.joinotify.com/messages
curl -X POST https://api.joinotify.com/messages \
  -H 'Authorization: Bearer sk_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "text",
    "to": "5541987111527",
    "body": "Seu pedido #1042 saiu para entrega."
  }'

API espelhada (/v1)​

O mesmo contrato da Meta Cloud API, byte a byte. Se você já tem código escrito contra o Graph, só troca o domínio e o token — nada mais muda.

POST api.joinotify.com/v1/{PHONE_NUMBER_ID}/messages
curl -X POST https://api.joinotify.com/v1/106540352242922/messages \
  -H 'Authorization: Bearer sk_live_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5541987111527",
    "type": "text",
    "text": { "body": "Olá!" }
  }'

Veja Compatibilidade com a Meta para a tabela de substituição completa e a lista de endpoints bloqueados.

Além do envio​

A mesma chave dá acesso ao que o painel faz com as conversas:

  • Contatos — a base de contatos, campos próprios e consentimento de marketing, para manter o seu CRM em sincronia.
  • Fluxos — dispare do seu sistema uma automação montada no editor.
  • Fluxos por webhook — a sua loja inicia um fluxo mandando os dados dela para uma URL.
  • Campanhas — um template para um público inteiro, com agendamento e pausas automáticas.
  • Inbox — as conversas da equipe, para ligar um helpdesk ou um bot.

Coexistência com o WhatsApp Business App​

Um número conectado ao Joinotify pode continuar sendo usado no aplicativo do WhatsApp Business no celular. O histórico de conversas e a lista de contatos podem ser sincronizados para a Cloud API logo após a conexão — é o modo coexistência.

Recebendo eventos​

Toda mensagem recebida, atualização de status de entrega e mudança em templates chega até você por webhook, no mesmo envelope que a Meta usa. Assinamos cada entrega com HMAC e reentregamos automaticamente em caso de falha.

Comece por Webhooks.

Próximos passos​