Acesso e segurança
Confirme autenticação, permissões e cuidados com credenciais. Mantenha segredos no backend da sua aplicação.
DEVELOPER EXPERIENCE
Acesse a referência técnica e prepare sua primeira integração.
Acesse a documentação técnica publicada pela equipe para consultar contratos e exemplos vigentes.
Acessar documentação técnicaNão teste endpoints por suposição. Este site não oferece um console conectado à API.
Contrato público v1. Execute no seu backend com uma instância conectada e acesso ativo. O retorno 202 aceita o processamento; não confirma entrega.
curl --request POST "https://app.connect.mydev.com.br/api/v1/instances/INSTANCE_ID/messages" \
--header "Authorization: Bearer $CONNECT_TOKEN" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
--data '{"to":"DESTINATARIO","text":"Olá!"}'
const response = await fetch(
`https://app.connect.mydev.com.br/api/v1/instances/${process.env.CONNECT_INSTANCE_ID}/messages`,
{
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.CONNECT_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ to: process.env.CONNECT_TO, text: 'Olá!' }),
},
);
if (!response.ok) throw new Error(`Connect: HTTP ${response.status}`);
const result = await response.json();
$instance = rawurlencode(getenv('CONNECT_INSTANCE_ID'));
$ch = curl_init("https://app.connect.mydev.com.br/api/v1/instances/$instance/messages");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 20,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer '.getenv('CONNECT_TOKEN'),
'Accept: application/json',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['to' => getenv('CONNECT_TO'), 'text' => 'Olá!']),
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($body === false || $status >= 400) throw new RuntimeException('Falha ao enviar pelo Connect');
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
Substitua os placeholders. Nunca exponha tokens no navegador. Referência técnica e erros.
SEU CHECKLIST TÉCNICO
Confirme autenticação, permissões e cuidados com credenciais. Mantenha segredos no backend da sua aplicação.
Verifique endpoints, formatos, códigos de resposta e limites no contrato vigente do produto.
Valide a disponibilidade de webhooks e planeje o comportamento do seu sistema em caso de indisponibilidade.
A API v1 usa a base https://app.connect.mydev.com.br/api/v1, JSON e autenticação Bearer. GET /health é público. Use a referência externa para os contratos completos.
Consulte o plano, acesse a plataforma e siga a documentação para configurar a conexão. Endereços, credenciais e primeira chamada precisam ser os publicados pelo produto.
Mantenha credenciais no backend. Confirme como obtê-las, enviá-las e revogá-las na referência técnica; nenhum token deve ser inserido nos exemplos deste site.
Confira no plano a quantidade de conexões e na documentação os estados, o método de vinculação e as regras de reconexão.
Valide destinatário, formatos, tamanho e significado da resposta antes de incorporar a chamada ao seu fluxo. Uma solicitação aceita não comprova entrega.
Confirme os formatos de entrada e quais dados ficam disponíveis para relacionar uma mensagem ao contexto do seu sistema.
Configure webhook_url na instância e valide X-Connect-Signature com HMAC-SHA256 sobre o corpo bruto e webhook_secret. Use X-Connect-Delivery para deduplicação. Os eventos são message.received, message.status e instance.status.
Use os códigos reais da documentação para distinguir falha de autenticação, dados inválidos, limites e indisponibilidade. Não repita envios sem entender o risco de duplicação.
Os exemplos acima seguem o contrato público v1 de envio de texto. Configure token, instância conectada e destinatário no seu backend. Eles não foram executados com credenciais nesta auditoria. A referência externa contém os detalhes completos.
Compare os limites vigentes na página de planos. Planeje contingência para desconexões e restrições inerentes à integração não oficial.
SEU PRÓXIMO BUILD COMEÇA AQUI
Vamos encontrar o lugar da comunicação no seu produto.