Reconectando uma Instância WABA

Reconexão de Instância WABA

curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "waba": {
    "access_token": "EAAxxxxxxx...",
    "phone_number_id": "1016102021584086",
    "waba_id": "419378847918255"
  }
}
'

import requests

url = "https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect"

payload = { "waba": {
        "access_token": "EAAxxxxxxx...",
        "phone_number_id": "1016102021584086",
        "waba_id": "419378847918255"
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    waba: {
      access_token: 'EAAxxxxxxx...',
      phone_number_id: '1016102021584086',
      waba_id: '419378847918255'
    }
  })
};

fetch('https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'waba' => [
        'access_token' => 'EAAxxxxxxx...',
        'phone_number_id' => '1016102021584086',
        'waba_id' => '419378847918255'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect"

	payload := strings.NewReader("{\n  \"waba\": {\n    \"access_token\": \"EAAxxxxxxx...\",\n    \"phone_number_id\": \"1016102021584086\",\n    \"waba_id\": \"419378847918255\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"waba\": {\n    \"access_token\": \"EAAxxxxxxx...\",\n    \"phone_number_id\": \"1016102021584086\",\n    \"waba_id\": \"419378847918255\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"waba\": {\n    \"access_token\": \"EAAxxxxxxx...\",\n    \"phone_number_id\": \"1016102021584086\",\n    \"waba_id\": \"419378847918255\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "created_at": "2024-10-03T21:56:22.620Z",
  "id": "xy9rexnkwobmgg3tehgvs",
  "metadata": {
    "customer_id": "123456",
    "customer_name": "Joãozinho",
    "phone_number": "+5587989075555"
  },
  "name": "MyNewInstance2",
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "display_name": null
  },
  "settings": {
    "delay_per_word": true,
    "delete_chat_after_sent": true,
    "message_delay": {
      "enabled": true,
      "max": 10,
      "min": 1
    }
  },
  "status": "disconnected",
  "webhooks": [
    {
      "enabled": true,
      "events": [
        "message.received"
      ],
      "id": "2nenz69l0xbf0m3uu9tfo",
      "name": "Webhook Name",
      "test_mode": false,
      "url": "https://webhook.mydomain.com",
      "test_url": null
    }
  ],
  "connection_type": "unofficial",
  "qrcode": null,
  "lookup_key": "ins_8j7wlxmpjlixx9mux5"
}

{
  "errors": [
    {
      "code": "invalid_type",
      "message": "WABA access token is required."
    }
  ]
}

{
  "errors": [
    {
      "code": "waba_invalid_token",
      "message": "The provided WABA access token is invalid or has expired. Please verify your credentials."
    }
  ]
}

{
  "errors": [
    {
      "code": "instance_not_found",
      "message": "Instance not found."
    }
  ]
}

{
  "errors": [
    {
      "code": "instance_not_disconnected",
      "message": "The instance must be disconnected to perform this action. Current status: \"connected\"."
    }
  ]
}

POST

instances

{instance_id}

reconnect

Reconexão de Instância WABA

curl --request POST \
  --url https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "waba": {
    "access_token": "EAAxxxxxxx...",
    "phone_number_id": "1016102021584086",
    "waba_id": "419378847918255"
  }
}
'

import requests

url = "https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect"

payload = { "waba": {
        "access_token": "EAAxxxxxxx...",
        "phone_number_id": "1016102021584086",
        "waba_id": "419378847918255"
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    waba: {
      access_token: 'EAAxxxxxxx...',
      phone_number_id: '1016102021584086',
      waba_id: '419378847918255'
    }
  })
};

fetch('https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'waba' => [
        'access_token' => 'EAAxxxxxxx...',
        'phone_number_id' => '1016102021584086',
        'waba_id' => '419378847918255'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect"

	payload := strings.NewReader("{\n  \"waba\": {\n    \"access_token\": \"EAAxxxxxxx...\",\n    \"phone_number_id\": \"1016102021584086\",\n    \"waba_id\": \"419378847918255\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"waba\": {\n    \"access_token\": \"EAAxxxxxxx...\",\n    \"phone_number_id\": \"1016102021584086\",\n    \"waba_id\": \"419378847918255\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"waba\": {\n    \"access_token\": \"EAAxxxxxxx...\",\n    \"phone_number_id\": \"1016102021584086\",\n    \"waba_id\": \"419378847918255\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "created_at": "2024-10-03T21:56:22.620Z",
  "id": "xy9rexnkwobmgg3tehgvs",
  "metadata": {
    "customer_id": "123456",
    "customer_name": "Joãozinho",
    "phone_number": "+5587989075555"
  },
  "name": "MyNewInstance2",
  "owner": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "display_name": null
  },
  "settings": {
    "delay_per_word": true,
    "delete_chat_after_sent": true,
    "message_delay": {
      "enabled": true,
      "max": 10,
      "min": 1
    }
  },
  "status": "disconnected",
  "webhooks": [
    {
      "enabled": true,
      "events": [
        "message.received"
      ],
      "id": "2nenz69l0xbf0m3uu9tfo",
      "name": "Webhook Name",
      "test_mode": false,
      "url": "https://webhook.mydomain.com",
      "test_url": null
    }
  ],
  "connection_type": "unofficial",
  "qrcode": null,
  "lookup_key": "ins_8j7wlxmpjlixx9mux5"
}

{
  "errors": [
    {
      "code": "invalid_type",
      "message": "WABA access token is required."
    }
  ]
}

{
  "errors": [
    {
      "code": "waba_invalid_token",
      "message": "The provided WABA access token is invalid or has expired. Please verify your credentials."
    }
  ]
}

{
  "errors": [
    {
      "code": "instance_not_found",
      "message": "Instance not found."
    }
  ]
}

{
  "errors": [
    {
      "code": "instance_not_disconnected",
      "message": "The instance must be disconnected to perform this action. Current status: \"connected\"."
    }
  ]
}

Use este endpoint para reconectar uma instância da API oficial (WABA) que foi desconectada, sem precisar excluí-la e criar outra. O ID da instância, os webhooks cadastrados e as configurações permanecem exatamente como estavam — você só fornece novamente as credenciais do número. Apenas instâncias com status disconnected podem ser reconectadas. Se a instância ainda estiver conectada, desconecte-a primeiro ou continue usando-a normalmente.

Credenciais

Envie o objeto waba com access_token, phone_number_id e waba_id — os mesmos campos aceitos na criação de instância. Campos opcionais como app_id, app_secret, webhook_verify_token e auth_method também são aceitos.

Se o número foi conectado pelo login com o Facebook, em vez de um token gerado no Meta Business Manager, faça a reconexão pelo painel da Zapster. Esse login precisa acontecer em uma página hospedada por nós e não pode ser reproduzido por chamada de API.

O que acontece na reconexão

Você não precisa refazer nada do que já estava configurado. Ao receber as credenciais, a Zapster:

Confere o token com a Meta, para garantir que ele é válido e tem acesso ao número informado.
Guarda as credenciais com segurança, criptografadas.
Aponta as mensagens do número de volta para a sua instância, para que os webhooks voltem a chegar no endereço que você já tinha cadastrado.
Conclui o registro do número na Meta, quando ainda for necessário.

Terminado isso, a instância volta ao status connected e volta a enviar e receber normalmente. Como o ID não muda, nada precisa ser alterado no seu código. Se alguma etapa falhar — token inválido, por exemplo — a instância continua desconectada e a resposta traz o motivo. Basta corrigir e chamar de novo.

Exemplos

curl -X POST https://api.zapsterapi.com/v1/wa/instances/ozj35qv418rpmlrb/reconnect \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "waba": {
      "access_token": "EAAxxxxxxx...",
      "phone_number_id": "1016102021584086",
      "waba_id": "419378847918255"
    }
  }'

const instanceId = 'ozj35qv418rpmlrb'

const response = await fetch(
  `https://api.zapsterapi.com/v1/wa/instances/${instanceId}/reconnect`,
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer SEU_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      waba: {
        access_token: 'EAAxxxxxxx...',
        phone_number_id: '1016102021584086',
        waba_id: '419378847918255',
      },
    }),
  },
)

const instance = await response.json()
console.log(instance.status) // connected

import axios from 'axios'

const instanceId = 'ozj35qv418rpmlrb'

const { data: instance } = await axios.post(
  `https://api.zapsterapi.com/v1/wa/instances/${instanceId}/reconnect`,
  {
    waba: {
      access_token: 'EAAxxxxxxx...',
      phone_number_id: '1016102021584086',
      waba_id: '419378847918255',
    },
  },
  { headers: { Authorization: 'Bearer SEU_TOKEN' } },
)

console.log(instance.status) // connected

// Nunca chame a Zapster direto do navegador: o seu token daria acesso total
// à conta a quem abrisse o DevTools. Chame o seu próprio backend, e é ele
// quem fala com a Zapster usando o token guardado no servidor.
const response = await fetch('/api/instancias/ozj35qv418rpmlrb/reconectar', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    access_token: 'EAAxxxxxxx...',
    phone_number_id: '1016102021584086',
    waba_id: '419378847918255',
  }),
})

const instance = await response.json()
console.log(instance.status) // connected

import requests

instance_id = "ozj35qv418rpmlrb"

response = requests.post(
    f"https://api.zapsterapi.com/v1/wa/instances/{instance_id}/reconnect",
    headers={"Authorization": "Bearer SEU_TOKEN"},
    json={
        "waba": {
            "access_token": "EAAxxxxxxx...",
            "phone_number_id": "1016102021584086",
            "waba_id": "419378847918255",
        }
    },
    timeout=30,
)

instance = response.json()
print(instance["status"])  # connected

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	instanceID := "ozj35qv418rpmlrb"

	body, _ := json.Marshal(map[string]any{
		"waba": map[string]string{
			"access_token":    "EAAxxxxxxx...",
			"phone_number_id": "1016102021584086",
			"waba_id":         "419378847918255",
		},
	})

	url := fmt.Sprintf(
		"https://api.zapsterapi.com/v1/wa/instances/%s/reconnect",
		instanceID,
	)

	req, _ := http.NewRequest(http.MethodPost, url, bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer SEU_TOKEN")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var instance map[string]any
	json.NewDecoder(res.Body).Decode(&instance)
	fmt.Println(instance["status"]) // connected
}

<?php

$instanceId = 'ozj35qv418rpmlrb';

$payload = json_encode([
    'waba' => [
        'access_token'    => 'EAAxxxxxxx...',
        'phone_number_id' => '1016102021584086',
        'waba_id'         => '419378847918255',
    ],
]);

$ch = curl_init("https://api.zapsterapi.com/v1/wa/instances/{$instanceId}/reconnect");

curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer SEU_TOKEN',
        'Content-Type: application/json',
    ],
]);

$instance = json_decode(curl_exec($ch), true);
curl_close($ch);

echo $instance['status']; // connected

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ReconnectInstance {
    public static void main(String[] args) throws Exception {
        String instanceId = "ozj35qv418rpmlrb";

        String payload = """
            {
              "waba": {
                "access_token": "EAAxxxxxxx...",
                "phone_number_id": "1016102021584086",
                "waba_id": "419378847918255"
              }
            }
            """;

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(
                "https://api.zapsterapi.com/v1/wa/instances/"
                    + instanceId + "/reconnect"))
            .header("Authorization", "Bearer SEU_TOKEN")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

instance_id

string

obrigatório

ID da instância.

Corpo

application/json

waba

object

obrigatório

Credenciais da Cloud API da Meta do número que será reconectado.

Show child attributes

Resposta

Success

Estrutura de uma instância registrada na API.

created_at

string<date-time>

obrigatório

Data e hora de criação da instância no formato ISO 8601.

Exemplo:

"2024-10-03T21:56:22.620Z"

string

obrigatório

Identificador único da instância.

Exemplo:

"xy9rexnkwobmgg3tehgvs"

metadata

object

obrigatório

Metadados adicionais armazenados como chave e valor.

Show child attributes

Exemplo:

{
  "customer_id": "123456",
  "customer_name": "Joãozinho",
  "phone_number": "+5587989075555"
}

name

string

obrigatório

Nome da instância.

Exemplo:

"MyNewInstance2"

owner

object

obrigatório

Informações sobre o proprietário da instância.

Show child attributes

settings

object

obrigatório

Objeto opcional de configurações da sua instância.

Show child attributes

status

enum<string>

obrigatório

Status atual da instância

Opções disponíveis:

connected,

disconnected,

offline

Exemplo:

"disconnected"

webhooks

object[]

obrigatório

Lista de webhooks configurados para esta instância.

Show child attributes

connection_type

enum<string>

Tipo de conexão da instância:

unofficial: conexão via QR code (padrão)
waba: conexão via API oficial do WhatsApp (Cloud API da Meta)

Opções disponíveis:

unofficial,

waba

Exemplo:

"unofficial"

qrcode

string | null

QR Code da instância, caso disponível.

Exemplo:

null

lookup_key

string

Identificador de pesquisa criado anteriormente.

Exemplo:

"ins_8j7wlxmpjlixx9mux5"

Instâncias

Webhooks

Mensagens

Para Grupos

Utilidades

Reconectando uma Instância WABA

Credenciais

O que acontece na reconexão

Exemplos

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Credenciais

​O que acontece na reconexão

​Exemplos

Autorizações

Parâmetros de caminho

Corpo

Resposta

Credenciais

O que acontece na reconexão

Exemplos